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PREFACE 


This publication is oriented to the F level 

assembler program (the assembler) function- 

ing in the IBM System/360 Operating System 

(Primary Control Program, MFT, and MVT). 
This publication is divided into an 

introduction and four sections which de- 

scribe the following: 

l. Assembler options and data set require- 

ments. 

Use of IBM-provided cataloged procedures 

for assembling; assembling and linkage 

editing; assembling, linkage editing, 

executing assembler language source 

programs. 

Use and interpretation of the assembler 

listing. 

Programming considerations. 


As 


and 


ce 
4. 


In addition, the appendixes provide a pro- 
cedure for dynamic invocation of the assem- 
bly, a list and explanation of object out- 
put cards, and a sample program listing. 
Other System Reference Library publica- 
tions in the IBM System/360 Operating 
System series provide fuller, more detailed 
discussions of the topics introduced in this 
publication: a careful reading of the 
publication IBM System/360 Operating System: 
Concepts and Facilities, Order No. GC28-6535, 
is recommended. Knowledge of the assembler 
language is assumed. Where appropriate, the 
reader is directed to the following publica- 
tions: 





IBM System/360 Operating System: Job 


Control Language Reference, Order No. 
GC28-6704 


IBM System/360 Operating System: Storage 
Estimates, Order No. GC28-6551 


IBM System/360 Operating System: Job 
Control Language User”s Guide, Order No 
GC28-6703 


Fifth Edition (July, 1969) 


This edition corresponds to Release 18 of the IBM System/360 Operating System, 


IBM System/360 Operating System: Linkage 


Editor and Loader, Order No. GC28-6538 


IBM System/360 Operating System: 


Supervisor and Data Management Services, 
Order No. GC28-6646 


IBM System/360 Operating System: 


Supervisor and Data Management Macro 
Instructions, Order No. GC28-6647 


IBM System/360 Operating System: TESTRAN, 
Order No. GC28-6648 


IBM System/360 Operating System: 
Messages and Codes, Order No. GC28-6631 


IBM System/360 Operating System: 
Assembler Language, Order No. GC28-6514 


IBM System/360 Operating System: 


Utilities, Order No. GC28-6586 


IBM System/360 Operating System: FORTRAN 


IV_(E Library Subprograms, Order No. 
GC28-6596 


IBM System/360 Operating System: System 
Programmer”s Guide, Order No. GC28-6550 


IBM System/360 Operating System: FORTRAN 


IV _(E) Programmer”s Guide, Order No. 
GC28-6603 


IBM System/360 Operating System: COBOL 


(E) Programmer”s Guide, Order No. 
GC24-5029 


References to these publications are 
usually by a short title, e.g., Linkage 


Editor or Data Management Services. 


It is a major revision 


of, and obsoletes, GC26-3756-3. The major changes are addition of System /360 Model 85 programming 


information and a cataloged procedure for the Loader. 


Other changes are a new PARM field option (OS/DOS), 


increase in maximum Set symbol dimension, cataloged procedure support for dedicated work files, and new assembler 


statistics. Also, there are several editorial changes. 
next to the page number, 


An extensively modified page is denoted by the symbol e 


Specifications contained herein are subject to change from time to time. Any such changes will be reported 


in subsequent revisions or Technical Newsletters. 


Requests for copies of IBM publications should be made to your IBM representative or to the IBM Branch Office 


serving your locality, 


A form is provided at the back of this publication for reader’s comments. 


If the form has been removed, 


address comments to IBM Nordic Laboratory, Technical Communications, Box 962, S-181 09 Liding6 9, Sweden. 
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Through the medium of job control state- 
ments, the programmer specifies job 
requirements directly to the operating 
system, thus eliminating many of the 
functions previously performed by the 
operating personnel. The job consists 
of one or more job steps. For example, 
the job of assembling, linkage-editing, 
and executing a source program involves 
three job steps: 

1. Translating the source program, 
i.e., executing the assembler com- 
ponent of the operating system to 
produce an object module. 
Processing the output of the as- 
sembler, i.e., executing the 
linkage-editor component of the 
operating system to produce a load 
module. 

Executing the assembled and linkage- 
edited program, i.e., executing the 
load module. 


A procedure is a sequence of job control 
language statements specifying a job. Pro- 
cedures may enter the system via the input 
stream or from a library of procedures, 
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INTRODUCTION 


which are previously defined and contained 
in a procedure library. The input stream 
is the flow of job control statements 

and, optionally, input data entering the 
system from one input device. At the 
sequential scheduling system level of the 
operating system, only one input stream 
may exist at a time. (For a description 
of the operating system environment see 


IBM System/360 Operating System: Con- 
cepts and Facilities. 

The job definition (JOB), execute 
(EXEC), data definition (DD), and delimiter 
(/*) job control statements are shown in 
this publication as they are used to 
specify assembler processing. Detailed 
explanations of these statements are 
given in IBM System/360 Operating System: 
Job Control Language Reference. 

Operating system factors influencing 
program preparation, such as terminating 
the program, saving and restoring general 
registers, and linking of independently 
produced object modules, are discussed in 
Programming Considerations, as are guides 
to determine whether assembler dictionary 
sizes and complexity limitations of source 
statements will be exceeded. 


Introduction 1 
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ASSEMBLER OPTIONS AND DATA SET REQUIREMENTS 


ASSEMBLER OPTIONS 


The programmer may specify the 
assembler options in the PARM=: field of 

the EXEC statement. They must appear 

between two apostrophes, separated by commas 
with no imbedded blanks. They can appear 

in any order and, if an entry is ommitted, a 
standard setting will be assumed as shown | 
below under "Default Entry." 


following 


“DECK LOAD, TEST, XREF, 
or or or or or 
‘NODECK,NOLOACT),NOLIST,NOTEST,NOXREF, 


List ALGN OS RENT’ 
or or or 


NOALGN,DOS,NORENT’ 


PARM= LINECNT=nn, 


These options are defined as follows: 
DECK -- The object module is placed on 
the device specified in the SYSPUNCH DD 
statement. 
LOAD -~ The object module is placed on 
the device specified in the SYSGO DD 
statement. 


NOTE: Specification of the parameter 
LOAD causes object output to be written 
on a data set with ddname SYSGO. This 
action occurs independently of the output 
on SYSPUNCH caused by the parameter DECK. 
The output on SYSGO and SYSPUNCH is iden- 
tical except that SYSPUNCH is closed with 
a disposition of LEAVE, and SYSGO is 
closed with a disposition of REREAD. 


LIST -- An assembler listing is produced. 

TEST -- The object module contains the 
special source symbol table required 
by the test translator (TESTRAN) 
routine, 

XREF -- The assembler produces a cross- 
reference table of symbols as part of 
the listing. 

RENT -- The assembler checks for a possible 
coding violation of program re- 
enterability. 


The prefix NO is used with the above 
options to indicate which options are not 
wanted. 


LINECNT=nn This parameter specifies the 
number of lines to be printed between 
headings in the listing. The permis- 
sible range is 01 to 99 lines. 

NOALGN -- The assembler suppresses the 
diagnostic message IEU033 ALIGNMENT 
ERROR if fixed point, floating point, 
or logical data referenced by an instruc- 
tion operand is not aligned on the 
proper boundary. The message will be 
produced, however, for references to 
instructions (e.g., by a branch) which 
are not aligned on the proper (halfword) 
boundary. See the "Model 85 Programming 


Considerations" section for information 
on alignment requirements. 

ALGN -- The assembler does not suppress the 
alignment error diagnostic message. 

OS -- The assembler will have complete 
Operating System Assembler F capability. 

DOS -- The assembler will behave like Disk 
Operating System (DOS) Assembler F. 
CXD, DXD, and OPSYN assembler operations 
and Extended Precision (Model 85 and 195 
only) machine operations will be treated 
as undefined. L-type and Q-type DC and 
DS statements will be treated as unknown 
types and RLDs will appear in the Reloc- 
ation Dictionary in order of their occur- 
rence (unsorted). The DOS option is in- 
compatible with the LOAD, TEST, RENT, or 
NOALGN options. If any of these options 
are specified along with DOS, the assem- 
bler generates a diagnostic message 
(IEU078) and uses the default options 
NOLOAD, NOTEST, NORENT, or ALGN. 


If contradictory options are entered, 
e.g., LIST, NOLIST, the rightmost option, 
NOLIST, is used. 

The following is an example of specify- 
ing assembler options: 


EXEC PGM=IEUASM,PARM=’LOAD,NODECK,TEST’ 


DEFAULT ENTRY 


If no options are specified, the assembler 
assumes the following default entry. 


PARM=‘NOLOAD,DECK,LIST,NOTEST,XREF,LINECNT=55,ALGN,OS,NORENT’ 


The cataloged procedures discussed in 
this guide assume the default entry. How- 
ever, the programmer may override any or 
all of the default options (see "Over- 
riding Statements in Cataloged Proce- 
dures"). 


ASSEMBLER DATA SET REQUIREMENTS 


The assembler requires the following four 
data sets: 


@® SYSUT1, SYSUT2, SYSUT3 -- utility data 
sets used as intermediate external 
storage. 

@® SYSIN -- an input data set containing 


the source statements to be processed. 


In addition to the above, four additional 


data sets may be required: 


@® sSYSLIB -- a data set containing macro 
definitions (for macro definitions not 
defined in the source program) and/or 
source coding to be called for through 
COPY assembler instructions. 


@ SYSPRINT --- a data set containing output 
text for printing (unless NOLIST option 
is specified). 


@® SYSPUNCH -~ a data set containing object 
module output usually for punching (un- 
less NODECK option is specified). 


@ SYSGO -~ a data set containing object 
module output usually for the linkage 
editor (only if LOAD option is specified). 


The above data sets are described in the 
following text. The ddname that must be 
used in the DD statement describing the 
data set appears as the heading for each 
description. 


Ddnames SYSUT1, SYSUT2, SYSUT3 

These utility data sets are used by the 
assembler as intermediate external storage 
devices when processing the source pro- 
gram. The input/output device(s) assigned 
to these data sets must be capable of . 
sequential access to records. The as- 
sembler does not support multi-volume 
utility data sets. Refer to the Storage 
Estimate manual for the space required. 


Ddname SYSIN 


This data set contains the input to the 
assembler -- the source statements to be 
processed. The input/output device as- 
Signed to this data set may be either the 
device transmitting the input stream, or 
another sequential input device designated 
by the programmer. The DD statement 
describing this data set appears in the 
input stream. The IBM-supplied procedures 
do not contain this statement. 


Ddname SYSLIB 


From this data set, the assembler obtains 
macro definitions and assembler language 
statements to be called by the COPY as- 
sembler instruction. It is a partitioned 
data set and each macro definition or 
sequence of assembler statements is a 
separate member, with the member name being 
the macro instruction mnemonic or COPY 
code name. The data set may be defined as 
SYS1.MACLIB or a user's private macro 
definition or COPY library. SYS1.MACLIB 
contains macro definitions for the system 
macro instructions provided by IBM. A 
user's private library may be concatenated 
with SYS1.MACLIB. The two libraries must 


have the same attributes, i.e., 
blocking factors, block sizes, and record 
formats. The Job Control Language publica- 
tion explains the concatenation of data 
sets. 


the same 


Ddname SYSPRINT 


This data set is used by the assembler to 

produce a listing. Output may be directed 
to a printer, magnetic tape, or DASD. The 
assembler uses the machine code carriage- 

control characters for this data set. 


Ddname SYSPUNCH 


The assembler uses this data set to produce 
the object module. The input/output unit 
assigned to this data set may be either a 
card punch or an intermediate storage de- 
vice (capable of sequential access). 


Ddname SYSGO 


This is a DASD, magnetic tape, or card 
punch data set used by the assembler. It 
contains the same output text as SYSPUNCH. 
It is used as input for the linkage editor 
and may also be used as a punch device (see 
NOTE under "Assembler Options"). 


DEFINING DATA SET CHARACTERISTICS 


Before a data set can be made available 
to a problem program, descriptive infor- 
mation defining the data set must be 
placed into a data control block for the 
access routines. Sources of information 
for the data control block are keyword 
operands in the DCB macro instruction or, 
in some cases, the DD statement, data set 
label, or user's problem program. General 
information concerning data set definition 
is contained in the Data Management Services 
manual (see Preface). Characteristics of 
data sets supplied by the DCB macro instruc- 
tion are described in the Data Management 
Macro Instructions manual (see Preface) . 
The specific information that must be 
supplied depends upon the data set organi- 
zation and access method. The following 
access methods are used to process the 
assembler data sets: 


Access Method Data Sets 
QSAM (Queued Sequential) SYSPRINT, SYS- 


PUNCH, SYSGO, 
SYSIN 

BSAM (Basic Sequential) SYSUT1, SYSUT2, 
SYSUT3 


BPAM (Basic Partitioned) SYSLIB 


Table 1 summarizes the assembler capa- 
bilities and restrictions on record length 


Assembler Options and Data Set Requirements 3 
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e Table l. 


For 


core 





44K 
availability 


calculating 


requirements 


Data Set Characteristics 
















SYSLIB 


Fixed at 80 Fixed at 80 


User must specify 
In LABEL or DD card 


User must specify 
in LABEL or DD card 


F, FS, FBS, FB, 
FBST, FBT, FT, 
FST 


F, Fi, FBT, FT 


User must specify 
in LABE. or DD card, 
must be a multiple of 
LRECL 


User must specify 
in LABEL or DD card, 
must be a multiple of 
LRECL 


Optional; if 
omitted 2 is used 


Set by assembler 
to 1 


BLKSIZE times 
BUFNO can not be 
greater than 3600 


BLKSIZE can not 
be greater than 3600 


@) 


L1 = BLKSIZE 
times BUFNO 


L2 = BLXSIZE 














SYSPRINT 


Fixed at 121 


F and M set by 
assembler, user may 
specify B and/or T 

in label or DD card 


FM, FMB, FMT, FMBT 


Optional, but must 
be a multiple of 
LRECL; If omitted 
BLKSIZE=LRECL 


Optional; if 
omitted 2 is used 


BLKSIZE times 
BUFINO can not be 
greater than 1210 


L3 = BLKSIZE 
times BUFNO 


Minimum core required for the assembler is the largest of the following: 


Maximum core that the assembler can effectively use = 


es sneer erntite Limca mite eee eset nimmeneAtininesiemeeee nti tinea 















SYSPUNCH 









Fixed at 80 


F set by assemb- 
ler, user may spec- 
ify B and/or T in 
label or DD card 


F, FB, FT, FBT 


Optional, but must 
be a multiple of 
LRECL; if omitted 
BLKSIZE=LRECL 









Optional; if 
omitted 3 is used for 
unit record and 1 for 
other devices 












BLKSIZE times 
BUFNO can not be 
greater than 400 








L4 = BLKSIZE 
times BUFNO 


(1) 45056 


(2) 1, 


ly + Let 535,000 


U = undefined, F = fixed length records, B = blocked records, S = standard blocks, 
T = track overflow, M = machine code carriage control 


Blocking is not allowed on unit record devices. Blocking on other direct access can not 
be greater than the track size unless T is specified on RECFM 


For MVT environment add 5,000 for core required 


A smaller blocksize may have to be specified for SYSLIB if global 
or local dictionaries overflow. See item 4 under "Correction of 
Dictionary Overflow." 























+ Ly + 41000 
(3) Lg + ly +L, + 41000 







SYSUTI 
SYSGO SYSUT2 
SYSUT3 


F set by assemb- Fixed for U 
ler, user may spec- 
ify B and/or T in 


label or DD card 
F, FB, FT, FBT 


Optional, but must 
be a multiple of 
LRECL; if omitted 
BLKSIZE=LRECL 


User can not specify; 
maximum of 3624 
minimum of 1739 


Optional, if 
omitted 3 is used for 
unit record and 1 for 
other devices 


User can not specify; 
either 1 or 2 


BLKSIZE times 
BUF NO can not be 
greater than 400 


L5 = BLKSIZE 
times BUFNO 


and format, as well as the blocksize buff- 
ering facilities available to the user. The 
values shown in Table 1 are based upon the 
minimum core requirements of Assembler F 
(44K), which will allow a symbol table 
length of approximately 7000 bytes. If 
more than 44K is available, the block sizes 
and buffer numbers can be increased. How- 
ever, if the user specifies a combination 
of blocking and buffering which does not 
leave room for the symbol table, abnormal 
termination of the task may occur (ABEND 
804) when the assembler attempts to issue 

a GETMAIN macro instruction. 

In addition to the data set character- 
istics shown in Table 1, the following 
options are available to the user (refer to 
the Supervisor and Data Management Macro 
Instructions publication). Options not 
shown below are fixed by the assembler and 
cannot be specified. 


Data Sets Options 

DEVD (device type) 

BFALN (buffer boundary 
alignment) 

BUFL (buffer length) 

EROPT (error option) 


SYSIN, SYSPUNCH, 
SYSPRINT, SYSGO 


DEVD (device type) 

OPTCD (optional ser- 
vice for validity 
checking and 
chained scheduling) 


SYSUT1, 2, 3 


RETURN CODES 


Table 2 shows the return codes issued by 
the assembler for use with the COND=para- 
meter of JOB or EXEC statements. The 
COND= parameter is explained in IBM 


System/360 Operating System Job Control 
Language Reference (GC28-6704). 
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The return code issued by the assembler 
is the highest severity code that is: 


1. Associated with any error detected 
by the assembler (see Appendix A for 
diagnostic messages and severity 
codes). 

2% Associated with MNOTE messages pro- 
duced by macro instructions. 

33 Associated with an unrecoverable I/O 
error occurring during the assembly. 


If a permanent I/O error occurs on any of 
the assembler files or a DD card for a 
required data set is missing, a message is 
printed on SYSPRINT (or on the operator's 
console if the SYSPRINT DD card is missing 
or if the I/O error is on SYSPRINT) and a 
return with a user return code of 20 is 
given by the assembler. This terminates 
the assembly. 


Table 2. 


Return 
Code Explanation 
No errors detected 


Minor errors detected; successful program execution is 
probable 


Errors detected; unsuccessful program execution is possible 


12 Serious errors detected; unsuccessful program execution is 
probable 


Return Codes 











Critical errors detected; normal execution is impossible 


Unrecoverable I/O error occurred during assembly or 
missing data sets; assembly terminated 
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CATALOGED PROCEDURES 


This section describes four IBM-provided 
cataloged procedures: a procedure for as- 
sembling (ASMFC), a procedure for assem- 
bling and linkage editing (ASMFCL), and a 
procedure for assembling, linkage editing, 
and executing (ASMFCLG), and a procedure 
for assembling and loader-executing 
(ASMFCG). The procedures rely on conven- 
tions regarding the naming of device 
classes. These conventions, shown in Table 
3, must be incorporated into the system 
at system generation time. 


Device Naming Conventions 


Table 3. 


















Device Classname Devices Assigned 


SYSSQ Any devices allowing 
sequential access to records 
for reading and writing 

SYSDA Direct-access devices 

SYSCP Card punches 





To use cataloged procedures, EXEC state— 
ments naming the desired procedures are 
placed in the input stream following the 
JOB statement. Subsequently, the specified 
cataloged procedure is brought from a 
procedure library and merged into the in- 
put stream. 


HASM EXEC PGM=IEUASM,REGION=50K 
: //SYSLIB DD DSNAME=SYS1.MACLIB,DISP=SHR 
: HSYSUT1 DD DSNAME=&SYSUT1,UNIT=SYSSQ,SPACE=(1700,(400,50)), 
if SEP=(SYSLIB) 
: HSYSUT2 DD DSNAME&SYSUT2, UNIT=SYSSQ,SPACE=(1700,(400,50)) 
HSYSUT3 DD DSNAME=SYSUT3,SPACE=(1700,(400,50)), 
MH UNIT=(SYSSQ,SEP=(SYSUT2,SYSUT 1,SYSLIB)) 
4 HSYSPRINT DO SYSOUT=A 
7 /ISYSPUNCH DD SYSOUT=B 


Cataloged Procedures). The system name 1EUASM identifies Assembler F. 


PARM= or COND=parameters may be added to this statement by the EXEC statement that <alls the procedure (see Overriding Statements in 


The System Programmer's Guide discusses 
the placing of procedures in the procedure 


library. 


CATALOGED PROCEDURE FOR ASSEMBLY (ASMFC) 


This procedure requests the operating 
system to load and execute the assembler. 
The name ASMFC must be used to call this 
procedure. The result of execution is an 
object module, in punched card form, and 
an assembler listing. 

In the following example, input enters 
via the input stream. The statements 
entered in the input stream to use this 
procedure are: 


//jobname JOB 
//stepname EXEC PROC= ASMFC 
//ASM.SYSIN DD * 

| 


source program statements 
| 


I 
/* (delimiter statement) 


The statements of the ASMFC procedure 
are brought from the procedure library and 
merged into the input stream. 

Figure 1 shows the statements that make 
up the ASMFC procedure. 


This statement identifies the macro library data set. The data set name SYS1.MACLIB is an IBM designation. 
345 












These statements specify the assembler utility data sets. The device classname used here, SYSSQ, may represent a collection of tape 
drives, or direct-access units, or both. The I/O units assigned to this name are specified by the installation when the system is generated. 
A unit name, e.g., 23111 may be substituted for SYSSQ. The DSNAME parameters quarantee use of Dedicated Workfiles if this feature is 
part of the Scheduler. 


The SEP=subparameter in statement 5 and the SPACE=parameter in statements 3, 4, and 5 are effective only if the device assigned is a 
direct-access device: otherwise they are ignored. The space required is dependent on the make-up of the source program. 
The Job Control Language publication explains space allocation. 


This statement defines the standard system output class, SYSOUT=A, as the destination for the assembler listing. 





This statement describes the data set that will contain the object module produced by the assembler. 











Figure 1. Cataloged Procedure for Assembly (ASMFC) 


CATALOGED PROCEDURE FOR ASSEMBLY AND 
LINKAGE EDITING (ASMFCL) 


This procedure consists of two job steps: 
assembling and linkage editing. The name 
ASMFCL must be used to call this procedure. 
Execution of this procedure results in the 
production of an assembler listing, a 
linkage editor listing, and a load module. 

The following example assumes input to 
the assembler via the input job stream. It 
also makes provision in the //LKED job step 
for concatenating the input to the linkage 
editor from the //ASM job step with any 
additional linkage editor input in the in- 
put job stream. This additional input can 
be a previously produced object module 
which is to be linked to the object module 
produced by job step //ASM. 

An example of the statements entered in 
the input stream to use this procedure is: 


//ASM EXEC PGM=IEUASM,PARM=LOAD,REGION=50K 
/ISYSLIB DD DSNAME=SYS1.MACLIB,DISP=SHR 


HSYSUT1 DD 
Hf SEP=(SYSLIB) 


HISYSUT2 DD 
MSYSUT3 DD 


HSYSPRINT DD 
HSYSPUNCH OD 


SYSOUT=A 
SYSOUT=B 
//ISYSGO DD 
" DISP=(MOD,PASS) 


//LKED 
MH COND=(8,LT,ASM) 


HISYSLIN DSNAME=&LOADSET,D!ISP=(OLD,DELETE) 


MW DDNAMES=SYSIN 
2 /ISYSLMOD 


Ms DISP=(MOD,PASS) 


//SYSUT1 
i SPACE=(1024,(50,20)) 


H/SYSPRINT SYSOUT=A 
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//jobname JOB 
//stepname EXEC PROC=ASMFCL 
//ASM. SYSIN DD * 

' 


t 
source program statements 


/* 
//LKED.SYSIN DD * 
] 
i] 
i] 


necessary only if linkage 
editor is to combine modules 
or read linkage editor control 
information from the job stream 


object module or 
linkage editor 
control statements 
* 
4 The procedure is brought from the pro- 
cedure library and merged into the input 
stream. 

Figure 2 shows the statements that make 
up the ASMFCL procedure. Only those state- 
ments not previously discussed are 
explained. 


DSNAME=&SYSUT1,UN!IT=SYSSO,SPACE=(1700,(400,50)), 
DSNAME=&SYSUT2,UNIT=SYSSO,SPACE=(1700,(400,50)) 


DSNAME=&SYSUT3,SPACE=(1700,(400,50)), 
fi UNIT=(SYSSO,SEP=(SYSUT2,SYSUT1,SYSLIB)) 


DSNAME=&LOADSET,UNIT=SYSSQ,SPACE=(80,{200,50)), 


PGM=IEWL,PARM=XREF,LIST,NCAL),REGION=96K, 


DSNAME=&GOSET(GO),UNIT=SYSDA,SPACE-(1024,(50,20,1)), 


DSNAME=&SYSUT 1,UNIT=(SYSDA,SEP=(SYSLIN,SYSLMOD)), 


In this procedure the SYSGO DD statement describes a temporary data set -- the object module -- which is to be passed to the linkage editor. 


This statement initiates linkage editor execution. The linkage editor options in the PARM=field cause the linkage editor to produce a 
cross-reference table, module map, and a list of all contro! statements processed by the linkage editor. The NCAL option suppresses the 


automatic library call function of the linkage editor. 


This statement identifies the linkage editor input data set on the same one produced as output by the assembler. 


This statement is used to concatenate any input to the linkage editor from the input stream with the input from the assembler. 


This statement specifies the linkage-editor output data set (the load module). As specified, the data set will be deleted at the end of the job. If it is 
desired to retain the load module, the DSNAME parameter must be respecified and a DISP parameter added. See Overriding Statements in Cataloged 
Procedures, If the output of the linkage editor is to be retained, the DSNAME parameter must specify a library name and member name where the 
load module is to be placed. The DISP parameter must specify either KEEP or CATLG. 


This statement specifies the utility data set for the linkage editor. 


This statement identifies the standard output class as the destination for the linkage editor listing. 


® Figure 2. 





Cataloged Procedure for Assembling and Linkage Editing (ASMFCL) 
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CATALOGED PROCEDURE FOR ASSEMBLY, //iobname JOB 
LINKAGE EDITING, AND EXECUTION Lipton EXEC PROC=ASMFCLG 


(ASMFCLG) ee 


source program statements 


This procedure consists of three job 
steps: assembling, linkage editing, and ys 
executing. //LKED.SYSIN DD * 


Figure 3 shows the statements that make 


up the ASMFCILG procedure. Only those cbinktmedule ee 

statements not previously discussed are linkage editor 

explained in the figure. conivol aidtenients 
The name ASMFCLG must be used to call f* : 

chis procedure. Assembler and linkage //GO.ddname DD (parameters) 

editor listings are produced. Gidneteaie ae iporanaters) 
The statements entered in the input ne ; 

stream to use this procedure are: ’ 


' 
problem program input 
t 


necessary only if linkage 
editor is to combine modules 
or read linkage editor control 
information from the job stream 


only if 
necessary 


/* I 
//ASM EXEC PGM=IEUASM,PARM=LOAD,REGION=50K 
//ISYSLIB DD OSNAME=SYS1.MACL!B,DISP=SHR 
HSYSUT1 DD DSNAME=&SYSUT1,UNIT=SYSSO,SPACE=(1700,(400,50)}), xX 
i SEP=(SYSLIB) 
IISYSUT2 DD DSNAME=&SYSUT2,UNIT=SYSSO,SPACE=(1700,(400,50)) 
/ISYSUT3 DD DSNAME=&SYSUT3,SPACE=(1700,(400,50)), X 
// UNIT=(SYSSO,SEP=(SYSUT2,SYSUT1,SYSLIB)) 
//SYSPRINT DD SYSOUT=A 
JISYSPUNCH DD SYSOUT=B 
//SYSGO DD DSNAME=&LOADSET,UNIT=SYSSQ,SPACE=(80,(200,50)), x 
I DISP=(MOD,PASS) 
1 //LKED EXEC PGM=IEWL,PARM=(XREF,LET,LIST,NCAL),REGION=96K, xX 
ai COND=(8,LT,ASM) 
/ISYSLIN DD DSNAME=&LOADSET,DISP=(OLD,DELETE) 
// DD DDNAMES=SYSIN 
- //ISYSLMOD DD DSNAME=&GOSET(GO),UNIT=SYSDA,SPACE=(1024,(50,20,1)), 4 
I DISP=(MOD,PASS) 
//ISYSUT1 DD DSNAME=&SYSUT1,UNIT=(SYSDA,SEP=(SYSLIN,SYSLMOD)), 
I SPACE=(1024,(50,20)) 
//SYSPRINT DD SYSOUT=A 
//GO EXEC PGM=".LKED.SYSLMOD,COND=((8,LT,ASM),(4,LT,LKED)) 







The LET linkage-editor option specified in this statement causes the linkage editor to mark the load module as executable even though errors were 
encountered during processing. 


The output of the linkage editor is specified as a member of a temporary data set, residing on a direct-access device, and is to be passed to a 
succeeding job step. 


This statement initiates execution of the assembled and linkage edited program. The notation *.LKED.SYSLMOD identifies the program to be 
executed as being in the data set described in job step LKED by the DD statement named SYSLMOD. When running with MVT (Option 4) the 
REGION parameter can be calculated with the help of the Storage Estimates publication (see preface). 





Figure 3. Cataloged Procedure for Assembly, Linkage Editing and Execution (ASMFCLG) 


CATALOGED PROCEDURE FOR ASSEMBLY AND 
LOADER-EXECUTION (ASMFCG) 


This procedure consists of two job steps 
assembling and loader-executing. The 
result of loader-execution is a combina~ 
tion of link-editing and loading the 
program for execution. Load modules for 
program libraries are not produced. 

Figure 4 shows the statements that make 
up the ASMFCG procedure. Only those state- 
ments not previously discussed are ex- 
plained in the figure. 

The name ASMFCG must be used to call 
this procedure. Assembler and loader 
listings are produced. 


The statements entered in the input stream 
to use this procedure are: 


//jobname JOB 
//stepname EXEC PROC=ASMFCG 
//ASM.SYSIN DD * 


source program 


Veal 

//GO.ddname DD 
//GO.ddname DD 
//GO.ddname DD 


(parameters) 


( parameters) only 


if 
necessary 


problem program input 


/* 


OVERRIDING STATEMENTS IN CATALOGED 
PROCEDURES 


Any parameter in a cataloged procedure can 
be overridden except the PGM= parameter in 
the EXEC statement. Such overriding of 
statements or fields is effective only 

for the duration of the job step in which 
the statements appear. The statements, 

as stored in the procedure library of the 
system, remain unchanged. 

Overriding for the purposes of re- 
specification, addition, or nullification 
is accomplished by including in the input 
stream statements containing the desired 
changes and identifying the statements 
to be overridden. 


EXEC Statements 


The PARM= and COND= parameters can be added 
or, if present, re-specified by including 
in the EXEC statement calling the pro- 
cedure the notation PARM.stepname=, or 
COND.stepname=, followed by the desired 
parameters. "Stepname" identifies the 

EXEC statement within the procedure to 
which the modification applies. Overriding 
the PGM= parameter is not possible. 


If the procedure consists of more than 
one job step, a PARM.stepname= or COND. 
stepname= parameter may be entered for 
each step. The entries must be in order, 
i.e., PARM.stepl=, PARM.step2=, etc. 


DD Statements 


All parameters in the operand field of DD 
statements may be overridden by including 
in the input stream (following the EXEC 
card calling the procedure) a DD statement 
with the notation //stepname.ddname in the 
name field. "Stepname" refers to the job 
step in which the statement identified by 
"ddname" appears. 


Examples 


In the assembly procedure ASMFC (Figure 1), 
the production of a punched object deck 
could be suppressed and the UNIT= and SPACE= 
parameters of data set SYSUT1 re-specified, 
by including the following statements in 
the input stream: 


//stepname EXEC PROC=ASMFC, 

// PARM. ASM=NODECK 
//ASM.SYSUTI DD UNIT=2311, x 
// SPACE=(200, (300, 40)) 
//ASM.SYSIN DD * 


In procedure ASMFCLG (Figure 3), suppress- 
ing production of an assembler listing and 
adding the COND= parameter to the EXEC 
statement, which specifies execution of the 
linkage editor, may be desired. [In this 
case, the EXEC statement in the input 
stream would appear as follows: 


//stepname EXEC PROC=ASMFCLG, Xx 
// PARM.ASM=(NOLIST,LOAD), x 
COND .LKED=(8 LT,stepname.ASM) 
NOTE: Overriding the LIST parameter ef- 


fectively deletes the PARM=LOAD so this 
must be repeated in the override statement. 


For current execution of procedure 
ASMFCLG, no assembler listing would be 
produced, and execution of the linkage 
editor job step //LKED would be suppressed 
if the return code issued by the assembler 
(step ASM) was greater than 8. Using the 
procedure ASMFCL (Figure 2) to: 


1. Read input from a non-labeled 9-track 
tape on unit 282 that has a standard 
blocking factor of 10. 

2. Put the output listing on a labeled tape 
VOLID=TAPE10, with a data set name of 
PROG1 and a blocking factor of 5, 

3. Block the SYSGO output of the assembler 
and use it as input to the linkage edi- 
tor with a blocking factor of 5. 
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//ASM EXEC PGM=IEUASM,PARM=’LOAD’,REGION=50K 

//SYSLIB DD DSNAME=SYS1.MACLIB,DISP=SHR 

//SYSUT1 DD DSNAME=&SYSUT1,UNIT=SYSSQ,SPACE=(1700,(400,50)), X 
// SEP=(SYSLIB) 

HSYSUT2 DD DSNAME=&SYSUT2,UNIT=SYSSQO,SPACE=(1700,(400,50)) 

H/SYSUT3 DD DSNAME=&SYSUT3,SPACE=(1700,(400,50)), Xx 
// UNIT=(SYSSO,SEP=(SYSUT2,SYSUT1,SYSLIB)) 


HSYSPRINT DD SYSOUT=A 
/ISYSPUNCH DD SYSOUT=B 


HSYSGO DD DSNAME=&LOADSE”™ ,UNIT=SYSSQ,SPACE=(80,(200,50)), X 
DISP=(MOD,PASS) 


1 





//GO EXEC PGM=LOADER,PARNV=‘MAP,PRINT,NOCALL,LET’ 
: HISYSLIN DD DSNAME=&LOADSET,DISP=(OLD,DELETE) 


//SYSLOUT DD SYSOUT=A 





This statement initiates loacer-execution. The loader options in the PARM=field cause the loader to produce a map, print the map and diagnostics. 
The NOCALL option is the same as NCAL for linkage editor and the LET option is the same as for linkage editor. 


2 This statement defines the loader input data set as the same one produced as output by the assembler. 


3 This statement identifies the standard output class as the destination for the loader listing. 

















Figure 4. Cataloged Procedure for Assembly and Loader-Execution (ASMFCG) 


4. ink edit the module only if there are //stepname | EXEC PROC=ASMFC, PARM.ASM='LOAD! 

no errors in the assembler, i.e., COND=0. //ASM.SYSGO DD DSNAME=&LO ADSET, UNIT=SYSSQ, x 
5. Link edit on to a previously allocated // SPACE=(80, (100,50 

and cataloged data set USER.LIBRARY (100,50), X 

with a member name of PROG, the input // DISP=(MOD, PASS), DCB=(BLKSIZE=400) 

stream appears as follows: //ASM.SYSIN DD : 
$ 
' 
// jobname JOB 1 
source program | statements 
//stepname EXEC PROC=ASMFCL, x 
// COND .LKED=(0, NE, steprame. ASM) yt 
//ASM.SYSPRINT DD DSNAME=PROGI,UNIT=TAPE, x //stepname2 EXEC PROC=ASMFCLG 
he VOLUME=SER=TAPE10, DCB=(BLKSIZE=605) //ASM.SYSGO DD DCB=(BLKSIZE=400), DISP=(MOD , PASS) 
//ASM.SYSGO DD  DCB=(BLKSIZE=400) //ASM.SYSIN DD 
//ASM.SYSIN DD  -UNIT=282, LABEL=(, NL), x 
If DCB=(RECFM=FSB, BLKSIZE=800) 
//LKED .SYSIN DD  DCB=stepname.ASM.SYSGO Rage, progiom2 statements 
//LKED.SYSLMOD DD  DSNAME=USER.LIBRARY(PROG),DISP=OLD 
1 
/* ft 1 
NOTE: The order of appearance of ddnames //LKED.SYSLIN DD DCB= BLKSIZE=400 
within job steps ASM and LKED has been pre- //LKED.SYSIN DD * 
served. Thus, SYSPRINT precedes SYSGO with- ENTRY PROG 
in step ASM. The ddname ASM.SYSIN was /* 
placed last since SYSIN does not occur at Bass 
all within step ASM. These points are (PSC sednane dd cards for GO step 
covered in the section "Using Cataloged 
Procedures" in the Job Control Language 
manual. 

To assemble two programs, link edit the | The Job Control Language Reference and 
two assemblies into one load module and ex- System Programmer”s Guide publications pro- 
ecute the load module. Entering at PROC, the vide additional description of overriding 
input stream appears as follows: techniques. 


10 


The assembler listing (Figure 5) consists 
of five sections, ordered as follows: ex- 
ternal symbol dictionary items, the source 
and object program statements, relocation 
dictionary items, symbol cross reference 
table, and diagnostic messages. [In addi- 
tion, three statistical messages may 
appear in the listing: 


dis After the diagnostics, a statements-— 
flagged message indicates the total 
number of statements in error. It 
appears as follows: nnn STATEMENTS 
FLAGGED IN THIS ASSEMBLY. 

2 After the statements-flagged message, 
the assembler prints the highest sever- 
ity code encountered (if non-zero). 
This is equal to the assembler return 
code. The message appears as follows: 
nn WAS HIGHEST. SEVERITY CODE. 

ce After the severity code, the assembler 
prints a count of the number of 
records read from SYSIN and from SYS- 
LIB. It also prints the options for 
the assembly. (See the section 
"Assembler Options). These messages 
appear as follows: 


*STATISTICS* SOURCE RECORDS (SYSIN) = 
nmnnnn SOURCE RECORDS (SYSLIB)= nnnnn 
*OPTIONS IN EFFECT* xxxx,XXXXXX, etc. 


4. After the options in effect, the 
assembler prints a count of lines 
printed, which appears as follows: nnn 
PRINTED LINES. This is a count of the 
actual number of 121-byte records 
generated by the assembler; it may be 
less -than the total number of printed 
and blank lines appearing on the list- 
ing if the SPACE n assembler instruc- 
tion is used. For a SPACE n that does 
not cause an eject, the assembler 
inserts n blank lines in the listing 
by generating n/3 blank 121-byte 
records -- rounded to the next lower 
integer if a fraction results; e.g., 
for a SPACE 2, no blank records are 
generated. The assembler does not 
generate a blank record to force a 
page eject. 


In addition to the above items, the 
assembler prints the deck identification 
and current date on every page of the 
listing. If the timer is available, the 
assembler prints the time of day to the 
left ut the date on page 1 of the ESD 
listing. This is the time when printing 
starts, rather than the start of the assem- 
bly, and is intended only to provide unique 
identification for assemblies made on the 
same day. The time is printed as hh.mm, 


ASSEMBLER LISTING 


where hh is the hour of the day (midnight 
beginning at 00), and mm is the number of 
minutes past the hour. 


EXTERNAL SYMBOL DICTIONARY (ESD) 


This section of the listing contains the 
external symbol dictionary information 


f passed to the linkage-editor or loader in 


the object module. The entries describe 
the control sections, external references, 
and entry points in the assembled program. 
There are six types of entries, shown in 
Table 4, along with their associated fields. 
The circled numbers refer to the corres- 
ponding heading in the sample listing 

| (Figure 5). The X's indicate entries 
accompanying each type designation. 


Table 4. Types of ESD Entries 





@ @ id ® 
SYMBOL | TYPE ADDR | LENGTH] L 





1. This column contains the name of every 
external dummy section, control sec- 
tion, entry point, and external symbol. 

2. This column contains the type desig- 
nator for the entry, as shown in the 
table. The type designators are defined 
as: 


SD--Names section definition. The sym- 
bol appeared in the name field of 
a CSECT or START statement. 

LD--The symbol appeared as the operand 
of the ENTRY statement. 

ER--External reference. The symbol 
appeared as the operand of an EXTRN 
statement, or was defined as a V- 
type address constant. 

PC--Unnamed control section definition. 

CM--Common control section definition. 

XD--External dummy section (same as PR, 
Pseudo Register in the Linkage Editor 
manual). 


3. This column contains the external sym- 
bol dictionary identification number 
(ESDID). The number is a unique two- 
digit hexadecimal number identifying 
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EXTERNAL SYMBOL DICTIONARY 


OOO OD © 


EXAM Page ] 









SYMBOL TYPE ID ADDR LENGTH LD ID ‘ 00.16 4/11/66 
SAMPLR SD 0? 000000 000388 


LO DS ® 





! 

















i EXAM SAMPLE PROGRAM Page. -3 
| © ® ® © 
LOC OBJECT CODE ADDRI ADDR2 STMT SOURCE STATEMENT F 14FEBO6 4/11/66 
000000 47FO FOOA Q000A 594BEGIN B 10(0,15) BRANCH AROUND ID 
000004 05 60+ DC ALI(5) 
000005 C2C5C7C9D5 61+ DC —CLS'BEGIN' IDENTIFIER @ 
000A 90EC DOOC o000c 62+ STM 14,12, 12(13) SAVE REGISTERS 
00000E 05cO 63 BALR R12, 0 ESTABLISH ADDRESSABILITY OF PROGRAM SAMPLO57 
000010 64 USING *,R12 AND TELL THE ASSEMBLER WHATBASETOUSE  SAMPLOS8 
@ RELOCATION DICTIONARY @ 
EXAM Page ] 
@9 @ 
POS.ID REL.ID FLAGS ADDRESS 4/11/66 
ol 01 oc OOOIFC 
ol 01 oc 00020C 
ol 01 oc 00021C 
ol 01 oc 000204 
ol 01 oc 000334 
@ CROSS-REFERENCE SO) 
EXAM Page | 
a2 @ @® 9) 
SYMBOL LEN VALUE DEFN REFERENCES 4/11/66 


BEGIN 00004 000000 00059 0156 0158 0174 0184 0186 220 
EXIT 00004 00007E 00096 O11] 
HIGHER 00002 O0000F4 00130 0125 
1HB0005 ~= 00001: ~00007B 00093 0090 
IHBOOOSA 00002 00007C 00094 0089 


@ DIAGNOSTICS @ 





EXAM Page 1 
STMT ERROR COCE MESSAGE 4/11/66 
19 1EUO25 NEAR OPERAND COLUMN 7--RELOCATABILITY ERROR 
2] {EU035 NEAR OPERAND COLUMN 9--ADDRESSABILITY ERROR 


2 STATEMENTS FLAGGED IN THIS ASSEMBLY 
8 WAS HIGHEST SEVERITY CODE 
| *STATISTICS* SOURCE RECORDS (SYSIN) = 225 SOURCE RECORDS (SYSLIB) = 5 
*OPTIONS IN EFFECT* LIST, NODECK, NOLOAD, NORENT, XREF, NOTEST, ALGN, OS, LINE CNT = 58 
261 PRINTED LINES 


@eFigure 5. ssembler Listing 


the entry. It is used by the LD entry less than the number of bytes in the 

of the ESD and by the relocation unit of alignment, e.g., 7 indicates 

dictionary for cross-referencing the double word alignment. 

ESD. 5. This column contains the assembled 
4. This column contains the address of the length, in bytes, of the control 

symbol (hexadecimal notation) for SD- section (hexadecimal notation). 

and LD-type entries, and zeros for ER- 6. This column contains, for LD-type 


type entries. For PC- and CM-type 


entries, it indicates the beginning entries, the identification (ID) 


address of the control section. For number assigned to the ESD entry that 
AD—type entries, it indicates the identifies the control section in 
alignment by printing a number one which the symbol was defined. 


SOURCE AND OBJECT PROGRAM 


14. 


This section of the listing documents 
the source statements and the resulting 
object program. 


7. 


10. 


tbs 


12. 


iS. 


This is the four-character deck iden- 
tification. It is the symbol that 
appears in the name field of the first 
TITLE statement. The assembler 

prints the deck identification and 
date (item 16) on every page of the 
listing. 

This is the information taken from the 
operand field of a TITLE statement. 


NOTE: TITLE, SPACE and EJECT state- 
ments will not appear in the source 
listing unless the statement is con- 
tinued onto another card. Then the 
first card of the statement is printed 
However, any of these three types of 
statements, if generated as macro in- 
struction expansion, will never be 
listed regardless of continuation. 


Listing page number. Each section of 
the listing starts with page l. 

This column contains the assembled 
address (hexadecimal notation) of the 
object code. 

This column contains the object code 
produced by the source statement. The 
entries are always left-justified. 
The notation is hexadecimal. Entries 
are machine instructions or assembled 
constants. Machine instructions 

are printed in full with a blank 
inserted after every four digits 

(two bytes). Constants may be only 
partially printed (see the PRINT 
assembler instruction in the As- | 
sembler Language publication). 

These two columns contain effective 
addresses (the result of adding to- | 
gether a base register value and dis- 
placement value): 


a. The column headed ADDR1 contains 
the effective address for the 
first operand of an SS in- 
struction. 

b. The column headed ADDR2 contains 
the effective address of the 
second operand of any instruc- 
tion referencing storage. 


Both address fields contain six 
digits; however, if the high-order 
digit is a zero, it is not printed. 
This column contains the statement 
number. A plus sign (+) to the right 
of the number indicates that the state- 
ment was generated as the result of 
macro instruction processing. 


This column contains the source pro- 
gram statement. The following items 
apply to this section of the listing: 


ae Source statements are listed, 
including those brought into the 
program by the COPY assembler 
instruction, and including macro 
definitions submitted with the 
main program for assembly. 
Listing control instructions are 
not printed, except for the 
following case: PRINT is listed 
when PRINT ON is in effect and a 
PRINT statement is encountered. 


b. Macro definitions obtained from 
SYSLIB are not listed. 
C. The statements generated as the 


result of a macro instruction 
follow the macro instruction in 
the listing. 

d. Assembler or machine instructions 
in the source program that con- 
tain variable symbols are listed 
twice: as they appear in the 
source input, and with values 
substituted for the variahle 
symbols. 

e. Diagnostic messages are 
ed inline in the source 
object program section. 
indicator, ***ERROR***, follows 
the statement in error. . The 
message appears in the diagnostic 
section of the listing. 

ca MNOTE messages are listed inline 
in the source and object program 
section. An MNOTE indicator 
appears in the diagnostic section 
of the listing for MNOTE state- 
ments other than MNOTE *. The 
MNOTE message format is severity 
code, message text. 

Je The MNOTE * form of the MNOTE 
statements results in an inline 
message only. An MNOTE indicator 
does not appear in the diagnostic 
section of the listing. 

ci When an error is found in a 
programmer macro definition, it 
is treated the same as any other 
assembly error: the error 
indication appears after the 
statement in error, and a diag- 
nostic is placed in the list of 
diagnostics. However, when 
an error is encountered during the 
expansion of a macro instruction 
(system- or programmer-defined), 
the error indication appears in 
place of the erroneous statement, 
which is not listed. The error 
indication follows the last 
statement listed before the 


not list- 
and 
An error 
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erroneous statement was en- 
countered, and the associated 
diagnostic message is placed in 
the list of diagnostics. 

dz Literals that have not been 
assigned locations by an LTORG 
statement appear in the listing 
following the END statement. 
Literals are identified by the 
equal (=) sign preceding them. 

Va If the END statement contains an 
operand, the transfer address 
appears in the location column 
(LOC). 

k. In the case of COM, CSECT, and 
DSECT statements, the location 
field contains the beginning ad- 
dress of these control sections, 
i.e., the first occurrence. 

Ls In the case of EXTRN, ENTRY, and 
DXD instructions, the location 
Field and object code field are 
blank. 

m. For a USING statement, the loca- 
tion field contains the value of 
the first operand. 

n. For LTORG and ORG statements, the 
location field contains the loca- 
tion assigned to the literal pool 
or the value of the ORG operand. 

O. For an EQU statement, the loca- 
tion field contains the value 
assigned. 

Bs Generated statements always 
print in normal statement for- 
mat. Because of this, it is 
possible for a generated state- 
ment to occupy three or more con- 
tinuation lines on the listing. 
This is unlike source statements, 
which are restricted to two con- 
tinuation lines. 

This column contains the identifier 

of the assembler (F) and the date 

when this version was released by 

Systems Development Division to DPD 

Program Information Department. 

Current date (date run is made). 

Identification-sequence field from 

the scurce statement. 


RELOCATION DICTIONARY 


This section of the listing contains the 
reiocation dictionary informetion passed 
to the linkage editor in the object module. 
The entries describe the address constants 
in the assembled program that. are affected 
by relocation. 


18. 
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This column contains the external 
symbol dictionary ID number assigned 
to the ESD entry that describes the 
control section in which the address 
constant is used as an operand. 


19's 


20. 


21. 


This column contains the external sym- 
bol dictionary ID number assigned to 
the ESD entry that describes the con- 
trol section in which the referenced 
symbol is defined. 

The two-digit hexadecimal number in 
this column is interpreted as follows: 


First Digit. A zero indicates that 
the entry describes an A-type or 
Y-type address constant. A one 
indicates that the entry describes 
a V-type address constant. A two 
indicates that the entry describes 
a Q-type address constant. A 

three describes a CXD entry. 

Second Digit. The first three bits 
of this digit indicate the length 
of the constant and whether the 
base should be added or subtracted: 


Bits 0 and 1 Blt-2 
00 = 1 byte O= + 
O01 = 2 bytes l=- 
10 = 3 bytes 
11 = 4 bytes 


This column contains the assembled ad- 
dress of the field where the address 
constant is stored. 


CROSS REFERENCE 


This section of the listing information 
concerns symbols which are defined and 
used in the program. 


226 
23's 


24. 


25. 


26. 


This column contains the symbols. 
This column states the length (deci- 
mal notation), in bytes, of the field 
occupied by the symbol value. 

This column contains either the ad- 
dress the symbol represents, or a 
value to which the symbol is equated. 
This column contains the statement 
number of the statement in which the 
symbol was defined. 

This column contains the statement 
numbers of statements in which the 
symbol appears as an operand. In the 
case of a duplicate symbol, the assem- 
bler fills this column with the mes- 
sage: 


***kDUPLICATE** ** 


The following notes apply to the 
cross-reference section: 


e Symbols appearing in V-type ad- 
dress constants do not appear in 
the cross-reference listing. 


@ A PRINT OFF listing control in- 
struction does not affect the 
production of the cross~—reference 
section of the listing. 


@® In the case of an undefined symbol, 
the assembler fills columns 23, 24, 
and 25 with the message: 


*&*k kUNDEFINED****, 


DIAGNOSTICS 


This section contains the diagnostic mes- 
sages issued as a result of error condi- 
tions encountered in the program. The 
text, severity code, and explanatory notes 
for each message are contained in "Appendix 
A". 


27. This column contains the number of the 
statement in error. 

28. This column contains the message iden- 
tifier. 

29. This column contains the message, and, 
in most cases, an operand column point- 
er that indicates the vicinity of the 
error. In the following example, the 
approximate location of the addressa- 
bility error occurred in the 9th col- 
umn of the operand field: 

Example: 
STMT ERROR CODE MESSAGE 
21 (EU035 NEAR OPERAND COLUMN 9 == ADDRESSABILITY ERROR 


The following notes apply to the diag- 
nostic section: 
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@ An MNOTE indicator of the form MNOTE 
STATEMENT appears in the diagnostic 
section if an MNOTE statement other 
than MNOTE* is issued by a macro in- 
struction. The MNOTE statement itself 
is inline in the source and object 
program section of the listing. The 
operand field of an MNOTE* is printed 
aS a comment, but does not appear in 
the diagnostic section. 


@ A message identifier consists of six 
characters and is of the form: 
ITEUxxx 
IEU identifies the issuing agent 
as Assembler F, and xxx is a 
unique number assigned to the 
message. 


NOTE: Editing errors in system macro defini- 
tions (macro definitions included in a macro 
library) are discovered when the macro defi- 
nitions are read from the macro library. 
This occurs after the END statement has been 
read. They will therefore be flagged after 
the END statement. If the programmer does 
not know which of his system macros caused 
an error it is necessary to punch all system 
macro definitions used in the program, 
including inner macro definitions, and insert 
them in the program as programmer macro defi- 
nitions, Since the programmer macro defini- 
tions are flagged in-line. To aid in de- 
bugging it is advisable to test all macro 
definitions as programmer macro definitions 
before incorporating them in a library as 
system macro definitions. 
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PROGRAMMING CONSIDERATIONS 


This section consists of a number of dis- 
crete subjects about assembler language 
programming. 


SAVING AND RESTORING GENERAL REGISTER 
CONTENTS 


A problem program should save the values 
contained in the general registers upon com- 
mencing execution and, upon completion, re- 
store to the general registers these same 
values. Thus, as control is passed from the 
operating system to a problem program and, 
in turn, to a subprogram, the status of the 
registers used by each program is preserved. 
This is done through use of the SAVE and 
RETURN system macro instructions, 

The SAVE macro instruction should be the 
first statement in the program. It stores 
the contents of registers 14, 15, and 0 
through 12 in an area provided by the pro- 
gram that passes control. When a problem 
program is given control, register 13 
points to an area in which the general 
register contents should be saved. 

If the program calls any subprograms, 
or uses any operating system services other 
than GETMAIN, FREEMAIN, ATTACH, and XCTL, 
it must first save the contents of register 
13 and then load the address of an 18 full- 
word save area into register 13. This save 
area is in the problem program and is used 
by any subprograms or operating system 
services called by the problem program. 

At completion, the problem program re- 
stores the contents of general registers 
14, 15 and 0-12 by use of the RETURN system 
macro instruction (which also indicates 
program completion). The contents of regis- 
ter 13 must be restored before execution of 
the RETURN macro instruction. 

The coding sequence that follows illus- 
trates the basic process of saving and re- 
storing the registers. A complete discus- 
sion of the SAVE and RETURN macro instruc- 
tions and the saving and restoring of 
registers is contained in the Data Manage- 
ment Services and Data Management Macro- 
Instructions publications (see Preface). 








(14, 12) 





set up base register 


13, SAVEBLK+4 
13, SAVEBLK 


13, SAVEBLK+4 
(14, 12) 
18F'0! 





SAVEBLK j. 
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PROGRAM TERMINATION 


Completion of an assembler source program 
is indicated by using the RETURN system 
macro instruction to pass control from the 
terminating program to the program that in- 
itiated it. The initiating program may be 
the operating system or, if a subprogram is- 
sued the RETURN, the program that called it. 

In addition to indicating program com- 
pletion and restoring registers, the RE- 
TURN macro instruction may also pass a re- 
turn code -- a condition indicator that 
may be used by the program receiving control. 
If the return is to the operating system, 
the return code is compared against the 
condition stated in the COND= parameter of 
the JOB or EXEC statements. If return is 
to another problem program, the return 
code is available in general register 15, 
and may be used as desired. Register 13 
should be restored before issuing the RE- 
TURN macro instruction. 

The RETURN system macro instruction is 
discussed in detail in the Supervisor and 
Data Management Macro Instructions pub- 


lication. 
PARM FIELD ACCESS 


Access to information in the PARM field of 
an EXEC statement is gained through general 
register 1. When control is given to the 
problem program, general register 1 con- 
tains the address of a full word which, in 
turn, contains the address of the data area 
containing the information. 

The data area consists of a halfword con- 
taining the count (in binary) of the number 
of information characters, followed by the 
information field. The information field is 
aligned to a full-word boundary. The follow- 
ing diagram illustrates this process. 


General Register | 





Address of Full Word 









Points 
to Full Word 






Address of Data Area 






Points 
to 






Data Area 


Count in Binary 


Information Fils | 





MACRO DEFINITION LIBRARY ADDITIONS 


Source statement coding, to be retrieved 
by the COPY assembler instruction, and 


macro definitions may be added to the macro 
library. The IEBUPDTE utility program is 
used for this purpose. Details of this 
program and its control statements are con- 
tained in the Utilities publication. The 
following sequence of job control state- 
ments can be used to call the utility pro- 
gram and identify the needed data sets. 

It is assumed that the job control state- 
ments, IEBUPDTE program control statements, 
and data are to enter the system via the 
input stream. 


//jobname JOB 


stepname EXEC PGM=IlEBUPDTE, PARM=MOD 

SYSUTI DD DSNAME=SYS1.MACLIB, DISP=OLD 

SYSUT2 DD DSNAME=SYS1.MACLIB, DISP=OLD 
/SYSPRINT DD SYSOUT=A 


//SYSIN DD 


{EBUPDTE control statements and source statements or 
macro-definitions to be added to the macro-library 


(SYST. MACLIB) 


/* (delimiter statement) 


LOAD MODULE MODIFICATION - ENTRY POINT 
RESTATEMENT 


If the editing functions of the linkage 
editor are to be used to modify a load 
module, the entry point to the load module 
must be restated when the load module is 
reprocessed by the linkage editor. Other- 
wise, the first byte of the first control 
section processed by the linkage editor 
will become the entry point. To enable 
restatement of the original entry point, 
or designation of a new entry point, the 
entry point must have been identified 
originally as an external symbol, i.e., 
appeared as an entry in the external 
symbol dictionary. External symbol 
identification is done automatically by 
the assembler if the entry point is the 
name of a control section or START state- 
ment; otherwise, an assembler ENTRY state- 
ment must be used to identify the entry 
point name as an external symbol. 

When a new object module is added to or 
replaces part of the load module, the 
entry point is restated in one of three 
ways: 


@ By placing the entry point symbol in the 
operand field of an EXTRN statement 
and an END statement in the new object 
module. 


@ By using an END statement in the new 
object module to designate a new entry 
point in the new object module. 


@ By using a linkage editor ENTRY state- 
ment to designate either the original 
entry point or a new entry point for 
the load module. 


Further discussion of load module entry 
points is contained in the Linkage Editor 
publication. 


OBJECT MODULE LINKAGE 


Object modules, whether Assembler-, FOR- 
TRAN-, or COBOL-generated, may be combined 
by the linkage editor to produce a compo- 
site load module, provided each object 
module conforms to the data formats and 
linkage conventions required. This topic 
discusses the use of the CALL system macro 
instruction to link an assembler language 
"main" program to subprograms produced by 
FORTRAN and COBOL. The Supervisor and Data 
Management Macro Instructions publication 
contains additional details concerning 
linkage conventions and the CALL system 
Macro instruction. 

Figure 6 shows the statements used to 
establish the assembler program linkage 
to the called subprograms. 

If any input/output operations are per- 
formed by called subprograms, appropriate 
DD statements for the data sets used by the 
subprograms must be supplied. See the 
FORTRAN IV (E) Programmer's Guide publica- 
tion for explanation of the DD statements 
used to describe data sets for FORTRAN pro- 
grams and a description of the special FOR- 
TRAN data set record formats. The COBOL 


(E) Programmer's Guide publicaticn provides 
DD statement information for COBOL programs. 





DICTIONARY SIZE AND SOURCE STATEMENT COM- 
PLEXITY 


This section describes the composition of 
the assembler dictionaries and their entry 
sizes, and describes methods for determin- 
ing if the limits on source statement com- 
plexity will be exceeded. 

Dictionary entries, e.g., sequence sym- 
bol names, prototype symbolic parameters, 
vary in length. Therefore, the number of 
entries a dictionary can hold is determined 
by the types of entries. 

Source statement complexity -- the num- 
ber of symbols, characters, operators, de- 
limiters, references to length attributes, 
self—defining terms, literals, and expres- 
sions appearing in a source statement -- 
determines whether or not the source state- 
ment can be successfully processed. 
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SAVE (14,12) 


set up base register 


ST 13, SVAREA+4 
LA 15,SVAREA 
ST 15,8(13) 

LR 13,15 


CALL name, (V1,V2,V3),VL 


















kL 13, SVAREA+4 
RETURN = (14,12) 
SVAREA DC 18F'0! 
vi DC (data) 
V2 DC (data) 
V3 DC (data) 
END 













This is an example of OS linkage convention. See the publication Supervisor and Data Management Services for details. 
The symbol used for "name" in this statement is: 

a. The name of a subroutine or function, when the linkage is to ce FORTRAN-written subprogram. 

b. The name defined by the following COBOL statements in the procedure division: 

ENTER LINKAGE, ENTRY'name'. 

c» The name of a CSECT or START statement, or a name used in the operand field of an ENTRY statement in an assembler subprogram, 


The order in which the parameter list is written must reflect the order in which the called subprogram expects the argument. If the called routine is a 
FORTRAN-written function, the returned argument is not in the parameter list: a real or double precision function returns the value in floating point 
register zero; an integer function returns the value in general purpose register zero. 


CAUTION: When linking to FORTRAN-written sulsprograms, consideration must be given to the storage requirements of IBCOM (FORTRAN execution-time 
\/O and interrupt handling routines) which accompanies the compiled FORTRAN subprogram, In some instances the call for IBCOM is not automatically 
generated during the FORTRAN compilation, The FORTRAN IV Library publication provides information about IBCOM requirements and assembler state- 
ments used to call IBCOM. 


FORTRAN - written subprograms and FORTRAN library subprograms allow variable-length parameter lists in linkages which call them; therefore all linkages 
to FORTRAN subprograms are required to have the high-order bit in the last parameter in the linkage set to 1. COBOL-written subprograms have fixed- 
length calling linkages; therefore, for COBOL the high-order bit in the last parameter need not be set to 1. 


3 
This statement reserves the save area needed by the called subprogram, When control is passed to the subprogram, register 13 contains the address of this 
area, 


456 When linking to a FORTRAN or COBOL subprogram, the data formats declared in these statements are determined by the data formats required by 
the FORTRAN or COBOL subprograms. 


Figure 6. Linkage Statements 

DICTIONARIES USED IN CONDITIONAI ASSEMBLY macro definition in the program, and one 

AND MACRO INSTRUCTION EXPANSION local dictionary for the main portion of 

the program (those statements not within 

To accomplish macro instruction expansion a macro definition, also called "open 

and conditional assembly, the assembler code."). The contents of the local dic- 

constructs a general dictionary consisting tionaries are described in subsequent 

of two parts: one global dictionary for paragraphs, 

the entire program, and an area for all of The capacity of the general dictionary 

the local dictionaries. (global dictionary and all local diction- 
The global dictionary contains one en- aries) is up to 64 blocks of 1024 bytes 

try for each machine operation code, ex- each. The division of the dictionary into 

tended mnemonic operation code, assembler global and local sections is done dynami- 

operation code, macro instruction, and cally: as the global dictionary becomes 

global SET variable symbol. larger, it occupies blocks taken from the 
The local dictionary area consists of local dictionary area. Thus, the global 

one local dictionary for each different dictionary is always core resident. As it 
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expands into the local dictionary area, 
the local dictionaries may overflow onto 

a utility file. The size of the diction- 
aries in core depends upon core avail- 
ability. The minimum core allocation is 
three blocks for the global dictionary and 
two blocks for each local dictionary. 

Each block in the global and local 
dictionaries contains complete entries. 
Any entry not fitting into a block is 
placed in the next block; the remaining 
bytes in the current block are not used. 

The global and local dictionaries take 
two forms: one when the dictionary entries 
are collected, i.e., picked up during the 
initial scan of the source program, and 
one during the actual conditional assembly 
and macro generation, i.e., generation 
time. The following text describes the 
global and local dictionaries at both 
collection time and generation time. 


Global Dictionary at Collection Time 


One global dictionary is built for the 
entire program. It contains machine 
operation codes, extended mnemonic opera- 
tion codes, assembler operation codes, 
OPSYN defined operation codes, macro 
instruction mnemonics, and global SET 
variable symbols. One entry is made 

is shown in Table 5. 


@®Table 5. Global Dictionary Entries at 


Collection Time 





* 


* 
Each machine operation code 5 bytes plus mnemonic* 


Each extended mnemonic operation 
code or assembler operation 


6 bytes plus mnemonic* 





10 bytes plus mnemonic * 


7 bytes plus name* 


*One byte is used for each character in the name or mnemonic. 


Each macro mnemonic operation code 


Each global SET variable symbol 





**For the first two types of entries, a total of 
O6FE 14 (1790)¢) bytes of core is required. 


Fixed overhead for this dictionary is: 
8 bytes for the first block 
4 bytes for each succeeding block 
5 bytes for the last block 


@Table 6. 





Local Dictionaries at Collection Time 


For the main portion of the program (those 
statements not within a macro definition), 
one local dictionary is constructed in 
which ordinary symbols, sequence symbols, 
and local SET variable symbols are entered. 
In addition, one local dictionary is con- 
structed for each different macro defini- 
tion in the program. These local diction- 
aries contain one entry for each local SET 
variable symbol, sequence symbol, and 
prototype symbolic parameter declared 
within the macro definition. If a sequence 
symbol is defined before it is referenced, 
an extra entry for the symbol is made. 
Table 6 shows the size of each type of 
entry. 


Local Dictionary Entries at 
Collection Time 


Each sequence symbol 10 bytes plus name* 
Each local SET variable symbol 7 bytes plus name* 


Each prototype symbolic parameter 5 bytes plus name* 





Each ordinary symbol 
appearing in the main portion 
of the program. 


10 bytes plus name* 


*One byte is used for each character in the name or mnemonic. 


Fixed overhead for this dictionary is: 
8 bytes for the first block (if in the 
main program) 
32 bytes for the first block (if in a 
macro definition) 
4 bytes for each succeeding block 
5 bytes for the last block 


Global Dictionary at Generation Time 


The sizes of the global dictionary entries 
at generation time are shown in Table 7. 
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@Table 7. Global Dictionary Entries at 


Generation Time 























Each global SETA symbol (dimensioned) | 2 byte plus 4N* 


Each global SETA symbol 


(undimensioned) 















2 byte plus (N/8)* (N/8 is 
rounded to the next highest 
inte ger) 


Each global SETB symbol (dimensioned) 


Each global SETB symbol 


(undimensioned) 


Each global SETC symbol 
(dimensioned) 








Each global SETC symbol 
(undimensioned) 


*N = dimension 


Fixed overhead for this dictionary is 
4 bytes plus word alignment. 


Local Dictionaries at Generation Time 





Table 8 shows the sizes of the various 
entries appearing in the local dictionaries 
at generation time. 


eTable 8. Local Dictionary Entries at 


Generation Time 


















Each local SETA symbol 


(undimensioned) 













Each local SETB symbol (dimensioned) | 2 byte plus (N/8)* (N/8 is 
rounded to the next highest 


inte ger) 








Each local SETB symbol 
(undimensioned) 





Each local SETC symbol (dimensioned) 


Each local SETC symkol 











(undimensioned) 9 bytes 
Each ordinary symbol 
appearing in the main portion 5 bytes 


of the program, ** 





*Ne=dimension 
**These entries appear only in the main 
program local dictionary. 
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Fixed overhead for this dictionary is 
20 bytes plus word alignment. 


Additional Dictionary Requirements 


The generation time global dictionary and 
the generation time local dictionary for 
the main portion of the program must be 
resident in main storage. 

In addition, if the program contains any 
macro instructions, main storage is re- 
quired for the largest local dictionary of 
the macro definitions being processed. 
Furthermore, during processing of macro 
definitions containing inner macro instruc- 
tions, main storage is required for the 
generation time local dictionaries for the 
inner macro instructions contained within 
the macro definition. 

In addition to those requirements speci- 
fied for the local dictionary of the main 
portion of the program, each macro defini- 
tion local dictionary requires space for 
entries shown in Table 9. 


Table 9. 


Macro Definition Local 
Dictionary Parameter Table 











Entry 


Each character string (1) 


3 bytes plus L 


7 bytes plus L 







Each hexadecimal, binary, decimal, 
and character self-defining term (2) 


Each symbol (3) 







9 bytes plus L 






9 bytes plus 3N bytes plus Y: 


L = Length of BCD entry in bytes 
N_ = Number of entries in sublist 
YS Ey Pig Ea teas EA 


where E = size of an entry (formats 1,2, and 3 above) 


Fixed overhead for the macro definition 
local dictionary parameter table is 22 
bytes. Each nested macro instruction also 
requires space in its local dictionary for 
the following: 

Parameter pointer list 8 bytes plus 2N 
(N = the number 
of operands) 

8 bytes plus 
word alignment 


Pointers to parameter 
pointer list and 
parameter table 


Correction of Dictionary Overflow 


If an assembly is terminated at collection 
time with either a GLOBAL DICTIONARY FULL 
message (IEU053) or a LOCAL DICTIONARY FULL 


message (IEU054), the programmer can take 
one or more of the following steps: 


is Split the assembly into two or more 
parts and assemble each separately. 
2% Allocate more core for the assembler 


(the global and local dictionaries 
together can occupy up to 64K). 

3% Run the assembly under Assembler E, 
unless it includes features not 
allowed by Assembler E. (Due to its 
dictionary building algorithm, Assem- 
bler E can handle more symbols with a 
given size dictionary than can 
Assembler F.) 

4. Specify a smaller SYSLIB blocksize. 
Thus, if BLKSIZE=3600, try BLKSIZE= 
1800 or BLKSIZE=1200, reblock the 
library to the size chosen, and try 
the assembly again. 


If the assembly is terminated at genera- 
tion time with a GENERATION TIME DICTIONARY 
AREA OVERFLOWED message (IEU068), the pro- 
grammer should allocate more core to the 
assembler and re-assemble his program. If 
he cannot allocate more core to the assem- 
bler, the programmer should split the 
assembly into two or more parts and assem- 
ble each separately. 


SYMBOL TABLE OVERFLOW 


Assembler performance can degrade when 
the source text plus macro-generated 
statements contains many ordinary sym- 
bols. If these are more ordinary symbols 
than will fit in the symbol table, the 
assembler will make one or more additional 
passes over the text. No symbols will be 
lost, but assembly time will increase. 

In general, the assembler can handle 
400 ordinary symbols without overflow in 
its minimum core (See Table 1). Because 
of input and/or output blocking differ- 
ences, minimum core varies. It is approxi- 
mately 45,000 bytes for PCP, 49,000 bytes 
for MFT, and 51,000 bytes for MVT. The 
assembler can process one additional 
symbol for each 18 bytes above minimum 
core. 


SOURCE STATEMENT COMPLEXITY 


The complexity of a source statement is 
limited both by the macro generator and the 
assembler portions of the assembler. The 
following topics provide the information 
necessary to determine if statement- 
complexity limitations for either portion 
of the assembler are being exceeded. 


Macro Generation and Conditional Assembly 


Limitation 


For any statement which 


. Is a conditional assembly statement, 
Is a DC or DS statement, 

Is an EXTRN statement, 

- Contains a sequence symbol or a 
variable symbol, 

Is not a macro instruction or proto- 
type statement, 


mWDY PE 
e 


wn 


the total number of explicit occurrences of 


1. Ordinary symbols (includes machine 
mnemonics, assembler mnemonics, con- 
ditional assembly mnemonics, and macro 
instruction mnemonics), 

2. Variable symbols, 

3. Sequence symbols, 


must not exceed 50 for the entire state- 
ment. 

For macro instructions and prototype 
statements the number of occurrences of 
ordinary symbols, variable symbols, and 
sequence symbols must not exceed 50 in the 
name and operation fields combined; or in 
each operand unless the operand is a sub- 
list, in which case the limit is applied 
to each sublist operand. In any operand if 
a character string has the same form as a 
symbol, it is counted as a symbol. 


Examples of Counts: 


&B2 SETB (T'NAME EQ 'W’) count=3 (&B2,SETB, NAME) 
EXTRN A,B,C, &C count=5 (EXTRN,A,B,C, &C) 


Assembler Portion Limitations 


1. Generated statements may not exceed 236 
characters. Statement length includes 
name, operation, operand, and comments. 
If a comments field exists, the blank 
separating the operand and comments 
field is included in the statement 
length. The statement is truncated if 
it exceeds 236 characters. 

2. DC, DS, DXD, and literal DCs cannot 
contain more than 32 operands per 
statement. 


SYSTEM/360 MODEL 91 PROGRAMMING CONSIDERA- 
TIONS 


The assembly language programmer should be 
aware of the operational differences 
between the Model 91 and other System/360 
models. The Model 91 requires a simulation 
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routine to execute most decimal instructions | They are extended-precision (two doubleword) 


and it yields different floating-point in- 
structions execution results. The Model 91 
also decodes and executes instructions con- 
currently, 

These and other coding and timing con- 
siderations are discussed in detail in IBM 
System/360 Model 91 Functional Character- 
istics, Form A22-6907. 
tion on how to control sequential and non- 
sequential instruction execution is given 
below. 


The CPU maintains a logical consistency 
with respect to its own operations, includ- 
ing the beginning and ending of I/O opera- 
tions, but it does not assume responsibility 
for such consistency in the operations per- 
formed by asynchronous units. Consequently, 
for any asynchronous unit that depends upon 
a strict adherence to sequential (or serial) 
execution, a problem program must set up 
its own procedures to ensure the proper 
instruction sequence. 

For a program section that requires the 
serial or sequential execution of instruc- 


tions, the following 'no-operation' in- 
struction: 

BCR M,O where M # 0 
causes the instruction decoder to halt, 


and the instructions that have 
decoded to be executed. (This action is 
called a pipe-line drain.) On the Model 91, 
this instruction ensures that all the in- 
structions preceding it are executed before 
the instruction suceeding it is decoded. 

Use of this instruction should be minimized 
since it may affect the performance of the 
Model 91. 

Isolating an instruction by preceding it 
and succeeding it with a BCR instruction 
eliminates multiple imprecise interruptions 
from more than one instruction by virtue of 
the pipe-line drain effect. However, since 
multiple exceptions may occur in one in- 
struction, this technique does not eliminate 
a multiple imprecise interruption nor does it 
change an imprecise interruption into a pre- 
cise interruption. The use of the BCR in- 
struction does not assure a programmer that 
he can fix up an error situation. In general, 
the only information available will be the 
address of the BCR instruction. The length of 
the instruction preceding the BCR instruction 
is not recorded, and generally there is no 
way to determine what that instruction is. 


already been 


SYSTEM/360 MODEL 35 PROGRAMMING CONSIDER- 
ATIONS 


The Model 85 has two special features avail- 
able to the assembler language programmer. 


22 





floating point instructions and byte-oriented 
(unaligned) operands. Detailed information 
on these features is in the IBM System/360 
Principles of Operation manual (GA22-6821). 

Assembler F supports these features with 
mnemonic operation codes for the extended- 
precision instructions, a two doubleword 
data constant (DC), an option for suppres- 
sing the alignment error message, and an 
assembler instruction for equating one op- 
eration code to another. These assembler 
features are explained in the following 
paragraphs. 


Extended-Precision Machine Instructions 


The extended-precision arithmetic instruc- 
tions and the rounding instructions of the 
Model 85 are shown in Table 10. The data 
format for extended operands of the AXR, 
SXR, MXR, and LRDR instructions and for 
extended results of the AXR, SXR, MXR, MXDR, 
and MXD instructions is shown in Figure 7. 

A complete description of these instructions 
is in the Principles of Operation manual. 


OPSYN--Operation Code Equate Instruction 


A program containing the extended precision 
instructions cannot be executed success- 
fully on another System/360 model unless 
those instructions are converted into others 
that can be executed by the non-Model 85 
machine. The OPSYN assembler instruction 
helps provide a facility for doing this. 

The format of the OPSYN statement is: 


A OPSYN B 
where A is the name field of the statement 


and is a source code mnemonic; and B is an 
existing machine instruction mnemonic, an 


Table 10. 


Extended-Precision and Rounding 


Mnemonic ‘Op Code 


Instructions 


ADD NORMALIZED (extended operands, 
extended result) 

SUBTRACT NORMALIZED (extended 
operands, extended result) 

MULTIPLY (extended operands, 
extended result) 

MULTIPLY (long operands, 
extended result) 

MULTIPLY (long operands, 
extended result) 

LOAD ROUNDED (extended to long) 

LOAD ROUNDED (long to short) 


EXTENDED FLOATING POINT NUMBER (L) 


7 BIT 
CHARAC 
TERISTIC 
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HIGH ORDER HALF OF 
112 BIT FRACTION 


LOW ORDER HALF OF 
112 BIT FRACTION 


ie] 78 


Figure 7. 


extended mnemonic code, an operation code 
defined by a previous OPSYN statement, or 
blank. The OPSYN statement assigns to A 
all of the properties of B or, if B is blank, 
removes A from the Assembler F Opcode Table. 
If a programmer wishes to use, for exam- 
ple, MXR (extended multiply) on a non-Model 
85, he has at least two ways to do so: 

1. The programmer can remove MXR from the 
Assembler F Opcode Table and adda 
macro instruction named MXR as a user 
macro, in this manner: 


MXR OPSYN 
MACRO 
MXR 


&R1,&R2 


MEND 


The first statement removes MXR as a 
machine instruction and allows the 
programmer to define MXR as a macro 
instruction; without the OPSYN state- 
ment, Assembler F would continue to 
assemble MXR aS a machine instruction. 
The programmer may approximate MXR by 
"equating" it to MDR (multiply long): 


MXR OPSYN MDR 


The MDR instruction is then assembled 
for each occurrence of MXR in the 
source program. This allows him to 
debug his routine on a non-Model 85 
System/360 computer. Later, he can 
remove the OPSYN statement, reassemble 
the program, and run it on a Model 85. 


Support of Unaligned Data 


The Model 85 will execute unprivileged 
RX- and RS- format instructions with fixed- 
point, floating-point, or logical operands 
that are not on integral boundaries. 
Assembly of such instructions normally pro- 
duces the diagnostic message "IEU033 Align- 
ment Error". A new PARM option in the EXEC 
statement for the Assembler F, ALGN or 
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Extended-Precision Floating Point Format 


NOALGN, makes it possible to suppress the 
message and thereby obtain a "clean" assem- 
bly listing. The object code is not 
affected. 

Note that an assembled program that 
requires use of the byte-oriented operand 
feature must be run on a Model 85 or 195 
machine. Further, it cannot run success-~ 
fully under the Operating System if it 
violates any alignment restrictions imposed 
by OS. 


Type L Data Constant 


A Define Constant operand type, L, has 
been added to provide extended-precision 
floating-point constants for the programmer. 
It can be used as a Define Storage operand 
or ina literal. Unless changed by a 
length modifier, the Type L constant is 16 
bytes long and is aligned on a double word 
boundary. Its format is that of two 
contiguous Type D constants, as shown in 
Figure 7, except that it is assembled with 
the sign of the second double word equal 
to that of the first, and the characteris- 
tic of the second equal to that of the 
first minus 14, modulo 128. 


SYSTEM/360 MODEL 195 PROGRAMMING 
CONSIDERATIONS 


The Model 195 has the following. special 
features: concurrent instruction execution, 
extended-precision (two doubleword) floating- 
point instructions, and byte-oriented (un- 
aligned) operands. The previous descriptions 
of these features under "System/360 Model 91 
Programming Considerations" and "System/360 
Model 85 Programming Considerations" also 
apply to the Model 195. 

Detailed information on the Model 195 
can be found in IBM System/360 Model 195 
Functional Characteristics, Order No. 
GA22-6943. 
NOTE: The Model 195 does not need the decimal 
simulator routine used by the Model 91. 
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This appendix explains the messages issued by the assembler. 
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APPENDIX A. 


DIAGNOSTIC MESSAGES 


A more detailed description, 


including information on how the programmer can respond to a message, is included in 


IBM System/360 Operatin 


System Messages and Codes (GC28-6631). 


before responding to any message or calling IBM. 


Code 





IEUO001 


IEU002 


IEU003 


ITEU004 


IEU005 


ITEU006 


ITEU007 


IEU008 


IEU009 


IEU010 


IEU011 


IEU012 


IEU013 


IEU014 


Message 


DUPLICATION FACTOR 
ERROR 


RELOCATABLE DUPLI- 
CATION FACTOR 


LENGTH ERROR 


RELOCATABLE LENGTH 
S-TYPE CONSTANT IN 
LITERAL 


INVALID ORIGIN 


LOCATION COUNTER 
ERROR 


INVALID DISPLACEMENT 


MISSING OPERAND 


INCORRECT REGISTER 
SPECIFICATION 


SCALE MODIFIER ERROR 


RELOCATABLE SCALE 
MODIFIER 


EXPONENT MODIFIER 
ERROR 


RELOCATABLE EXPONENT 
MODIFIER 


Explanation 


A duplication factor is not an absolute 
expression, or is zero in a literal: * in 
duplication factor expression; invalid syntax 
in expression. 


A relocatable expression has been used to 
specify the duplication factor. 


The length specification is out of permissible 
range or specified invalidly: * in length 
expression: invalid syntax in expression; no 
left-parenthesis delimiter for expression. 


A relocatable expression has been used to 
specify length. 


S-type address constants may not be specified 
in a literal. 


The location counter has been reset to a value 
less than the starting address of the control 
section; ORG operand is not a simply relocatable 
expression or specifies an address outside the 
control section. 


The location counter has exceeded oot 24 or 
passed out of control section in negative 
direction (3 byte arithmetic). 


The displacement in an explicit address is not 
an absolute value within the range of 0 to 4095. 


Statement requires an operand entry and none is 
present. 


The value specifying the register is not an 
absolute value within the range 0-15, an odd 
register is specified where an even register 
is required, or a register was used where none 
can be specified. 


The scale modifier is not an absolute express- 


ion or is too large, negative scale modifier for 


floating point, * in scale modifier expression; 
invalid syntax or illegally specified scale 
modifier. 


A relocatable expression has been used to 
specify the scale modifier. 


The exponent is not specified as an absolute 
expression or is out of range; * in exponent 
modifier expression; invalid syntax; illegally 
specified exponent modifier. 


A relocatable expression has been used to 
specify the exponent modifier. 


Appendix A. 


Refer to this publication 


Severity 
Code 


12 


12 


12 


12 


12 


12 


12 
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Code 


ITEUO15 


IEU016 


IEU017 


TEUO18 


TEUO19 


TEU020 


TEUO021 


TEU022 


IEU023 


TEU024 


TEU025 


TEU026 


ITEU027 


TEU028 
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Message 


INVALID LITERAL USAGE 


INVALID NAME 


DATA ITEM TOO LARGE 


INVALID SYMBOL 


EXTERNAL NAME ERROR 


INVALID IMMEDIATE 
FIELD 


SYMBOL NOT 


PREVIOUSLY DEFINED 


ESDTABLE OVERFLOW 


PREVIOUSLY DEFINED 
NAME 


UNDEFINED SYMBOL 


RELOCATABILITY 
ERROR 


TOO MANY LEVELS OF 
PARENTHESES 


TOO MANY TERMS 


REGISTER NOT USED 


Explanation 


A valid literal is used illegally, e.g., it 
specifies a receiving field or a register, 
or it is a Q-type constant. 


A name entry is incorrectly specified, e.g., it 
contains more than 8 characters, 
with a letter, 
or--if the statement is OPSYN--the name entry is 


Severity 
Code 


8 


it does not begin 
it has a special character imbedded, 


not an ordinary symbol or is an assembler operation 


mnemonic. 


The constant is too large for the data type 
or for the explicit length; operand field 
for packed DC exceeds 32 characters and for 
zoned DC exceeds 16 characters (excluding 
decimal points). 


The symbol is specified invalidly, e.g., it is 
longer than 8 characters or--if the statement is 
OPSYN--the operand entry is not an ordinary sym- 
bol or is an assembler operation mnemonic. 


A CSECT and DSECT statement have the same 
name, or a symbol is used more than once in 
an EXTRN or the name field of DXD statements. 


The value of the immediate operand exceeds 255, 
or the operand requires more than one byte of 


storage, or the operand is not an acceptable type. 


An expression requiring that all symbols be pre- 
viously defined contains at least one symbol not 
previously defined. 


The combined number of control sections and 
dummy sections plus the number of unique 
symbols in EXTRN statements and V-type con- 
stants exceeds 255. (A DSECT which appears 
as XD makes two entries). 


The symbol which appears in the name field has 
appeared in the name field of a previous 
statement. 


A symbol being referenced has not been defined 
in the program. 


A relocatable or complex relocatable expression 
is specified where an absolute expression is 
required, an absolute expression or complex 
relocatable expression is specified where a 
relocatable expression is required, or a reloca- 
table term is involved in multiplication or 
division. 


An expression specifies more than 5 levels of 
parentheses. 


More than 16 terms are specified in an 
expression. 


A register specified in a DROP statement is not 
currently in use. 


12 


12 


12 


Code 
TEU029 


IEU030 


IEU031 


IEU032 


‘IEU033 


IEU034 


TEU035 


IEU0 36 


IEU037 


TEU038 


ITEU039 


IEU040 


TEU041 


ITEU042 


ITEU043 


IEU044 


Message 
CCW ERROR 


INVALID CNOP 
UNKNOWN TYPE 
OP-CODE NOT ALLOWED 


TO BE GENERATED 


ALIGNMENT ERROR 


INVALID OP-CODE 


ADDRESSABILITY ERROR 


(No message is 
assigned to 
this number) 


MNOTE STATEMENT 


ENTRY ERROR 


INVALID DELIMITER 


GENERATED RECORD 
TOO LONG 


UNDECLARED VARIABLE 
SYMBOL 


SINGLE TERM LOGICAL 
EXPRESSION IS NOT 
A SETB SYMBOL 


SET SYMBOL 
PREVIOUSLY DEFINED 


SET SYMBOL USAGE 
INCONSISTENT WITH 
DECLARATION 
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Severity 
Explanation Code 
Bits 37-39 of the CCW are set to non-zero. 8 
An invalid combination of operands is specified. 12 


Incorrect type designation is specified in a DC, DS, 
or literal. If the DOS option is specified, type Q 8 
will be flagged as unknown. (See "Assembler Options".) 


Operation code allowed only in source statement has 9 
been obtained through substitution of a value for a 
variable symbol. 


Referenced address is not aligned to the proper 4 
boundary for this instruction, e.g., START 
operand not a multiple of 8. 


NOTE: If a register is explicitly specified in the 
reference, no message is issued, e.g., L 3,3(REG4) 


Syntax error, e.g., more than 8 characters in 8 
operation field, not followed by blank on first 
card, missing. 


The referenced address does not fall within the 8 
range of a USING instruction. 


This indicates that an MNOTE statement has been Variable 
generated from a macro definition. The text and 
severity code of the MNOTE statement will be 
found in line in the listing. 
A symbol in the operand of an ENTRY statement 8 
appears in more than one ENTRY statement, it is 
undefined, it is defined in a dummy section or 
in blank common, or it is equated to a symbol 
defined by an EXTRN statement. 
This message can be caused by any syntax error, 

aes ae : 12 
e.g., missing delimiter, special character used 
which is not a valid delimiter, delimiter used 
illegally, operand missing, i.e., nothing 
between delimiters, unpaired parentheses, 
imbedded blank in expression. 
There are more than 236 characters ina 12 
generated statement. 
Variable symbol is not declared in a defined SET 8 
symbol statement or in a macro prototype. 
The single term logical expression has not been 8 
declared as a SETB symbol. 
Self-explanatory. 8 
A SET symbol has been declared as undimensioned, 8 


but is subscripted, or has been declared 
dimensioned, but is unsubscripted. 
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Code 


TEU045 


TEU046 


TEU047 


TEU048 


IEU049 


TEU050 


TEUO51 


TEU052 


TEU053 


TEU054 


TEU055 


TEU056 


IEU057 


IEU058 


ITEU059 


TEU060 


28 


Message 


ILLEGAL SYMBOLIC 
PARAMETER 


AT LEAST ONE RELOCAT- 
ABLE Y TYPE CONSTANT 
IN ASSEMBLY 


SEQUENCE SYMBOL 
PREVIOUSLY DEFINED 


SYMBOLIC PARAMETER 
PREVIOUSLY DEFINED OR 


SYSTEM VARIABLE SYMBOL 


DECLARED AS SYMBOLIC 
PARAMETER 


VARIABLE SYMBOL 
MATCHES A PARAMETER 


INCONSISTENT GLOBAL 
DECLARATIONS 


MACRO DEFINITION 
PREVIOUSLY DEFINED 


NAME FIELD CONTAINS 
ILLEGAL SET SYMBOL 


GLOBAL DICTIONARY 
FULL 


LOCAL DICTIONARY FULL 


INVALID ASSEMBLER 
OPTION(S) ON THE 
EXECUTE CARD 


ARITHMETIC OVERFLOW 


SUBSCRIPT NOT 
WITHIN DIMENSIONS 


RE--ENTRANT CHECK 
FAILED 


UNDEFINED SEQUENCE 
SYMBOL 


ILLEGAL ATTRIBUTE 
NOTATION 


Severity 

Explanation Code 
An attribute has been requested for a variable 
symbol which is not a legal symbolic parameter. 8 
One or more relocatable Y-type constants in 4 
assembly; relocation may result in address 
greater than 2 bytes in length. 
Self-explanatory. 12 
Self-explanatory. 12 
Self-explanatory. LZ 
A global SET variable symbol, defined in more 8 
than one macro definition or defined ina 
macro definition and in the source program, is 
inconsistent in SET type or dimension. 
Prototype operation field is the same as a LZ 
machine or assembler instruction or a previous 
prototype. This message is not produced when 
a programmer macro matches a system macro. The 
programmer macro will be assembled with no in- 
dication of the corresponding system macro. 
SET symbol in name field does not correspond 8 
to SET statement type. 
The global dictionary is full, assembly ter- 12 
minated. See Correction of Dictionary Over- 
flow. 
The local dictionary is full, current macro 12 
aborted. If in open code, assembly terminated. 
See Correction of Dictionary Overflow. 
Self-explanatory. 8 
The intermediate or final result of an a alge 8 
ion is not within the range of -231 to 231-1. 
&SYSLIST or symbolic parameter subscript exceeds 8 
200, or is negative, or zero, or SET symbol 
subscript exceeds dimension specified in LCL/GBL 
statement. 
An instruction has been detected, which, when 4 
executed, might store data into a control section 
or a common area. This message is generated only 
when requested via control cards and merely 
indicates a possible reentrant error. 
Self-explanatory. 12 
L', S', or I' requested for a parameter whose 8 


type attribute does not allow these attributes 
to be requested. 


Code 
TEUO061 
TEU062 
TEU063 


ITEU064 


ITEU065 


IEU066 


IEU067 


TEU068 


TEU069 


IEU070 


TEUO71 


IEU072 


IEU073 


IEU074 


TEU075 


Message 
ACTR COUNTER EXCEEDED 


GENERATED STRING 
GREATER THAN 255 
CHARACTERS 


EXPRESSION 1 OF SUB- 
STRING IS ZERO OR 
MINUS 


EXPRESSION 2 OF SUB- 
STRING IS ZERO OR 
MINUS 


INVALID OR ILLEGAL 
TERM IN ARITHMETIC 
EXPRESSION 


UNDEFINED OR DUP- 
LICATE KEYWORD 
OPERAND OR EXCESSIVE 
POSITIONAL OPERANDS 


EXPRESSION 1 OF SUB- 
STRING GREATER THAN 
LENGTH OF CHARACTER 
EXPRESSION 


GENERATION TIME 
DICTIONARY AREA 
OVERFLOWED 


VALUE OF EXPRESSION 
2 OF SUBSTRING 
GREATER THAN 8 


FLOATING POINT 
CHARACTERISTIC OUT 
OF RANGE 


ILLEGAL OCCURRENCE 
OF LCL, GBL, OR 
ACTR STATEMENT 


ILLEGAL RANGE ON 
ISEQ STATEMENT 


ILLEGAL NAME FIELD 


ILLEGAL STATEMENT 
IN COPY CODE OR 
SYSTEM MACRO 


ILLEGAL STATEMENT 
OUTSIDE OF A MACRO 
DEFINITION 


Explanation 


Self-explanatory, 


Self-explanatory. 


Self-explanatory. 


Self-explanatory. 


conditional assembly terminated. 


Severity 
Code 


12 


8 


The value of a SETC symbol used in the arith- 8 
metic expression is not composed of decimal 
digits, or the parameter is not a self-defining 


term. 


The same keyword operand occurs more than once 
in the macro instruction; 
defined in a prototype statement; 


12 
a keyword is not 
in a mixed 


mode macro instruction, more positional 
operands are specified than are specified in 


the prototype. 


Self-explanatory. 


See Correction of Dictionary Overflow and 2 
Dictionary Size and Source Statement Complexity. 


Self-explanatory. 


Exponent too large for length of defining 1:2 
field, exponent modifier has caused loss 
of all significant digits. 


LCL, GBL, or ACTR statement is not in proper 8 


place in the program. 


One or more columns to be sequence checked are be- 4 
tween the "begin" and "end" columns of the statement. 


Either a statement requires a name and the name 8 
field is blank or a statement has a name which 


should be blank or a 
a sequence symbol is 


name entry required to be 
not a sequence symbol. 


A statement brought in by a COPY statement is END, 8 


ICTL, ISEQ, 


ISEQ, or PRINT. 


Statement allowed only in a macro definition 


MACRO, MEND, 
mend in a system macro definition is END, 


or COPY. A model state- 
ICTL, 


encountered in OPEN code, e.g., period asterisk 
(.*), mnote statement. 
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Code 


IEU076 


ITEU077 


LEUO 7S 


IEU079 


TEU080 


TEU081 


TEU082 


TEU083 


TEUO084 


TEUO085 


TEU086 


TEU087 


TEU088 


TEU089 
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Message 
SEQUENCE ERROR 


ILLEGAL CONTINUATION 
CARD 


INCOMPATIBLE ASSEM- 
BLER OPTIONS ON THE 
EXECUTE CARD 


ILLEGAL STATEMENT 
IN MACRO DEFINITION 


ILLEGAL START CARD 


ILLEGAL FORMAT IN 
GBL OR LCL STATE- 
MENTS 


ILLEGAL DIMENSION 
SPECIFICATION IN GBL 
OR LCL STATEMENT 


SET STATEMENT NAME 
FIELD NOT A VARIABLE 
SYMBOL 


ILLEGAL OPERAND FIELD 
FORMAT 


INVALID SYNTAX IN 
EXPRESSION 


ILLEGAL USAGE OF 
SYSTEM VARIABLE 
SYMBOL 


NO ENDING APOSTROPHE 


UNDEFINED OPERATION 
CODE 


INVALID ATTRIBUTE 
NOTATION 


Severity 


Explanation __Code_ 
See "ISEQ--Input Sequence Checking" in the Assem- 12 
bler Language manual. 
Either there are too many continuation cards, 8 


or there are non-blanks between the begin and 
continue columns on the continuation card, or 

a card not intended as continuation was treated 
as such because of punch in continue column. 

of preceding card. 


The DOS assembler option has been specified along 8 
with the options LOAD, TEST, RENT, or NOALGN. The 
assembler has used the default options NOLOAD, 

NOTEST, NORENT or ALGN. 


This operation is not allowed within a macro 8 
definition. 
Statements affecting or depending upon the 8 


location counter have been encountered before 
a START statement. 


An operand is not a variable symbol. 8 
Dimension is other than 1 to 2500. 8 
Self-explanatory. 8 
Syntax invalid, e.g., AIF statement operand 8 


does not start with a left parenthesis; operand 
of AGO is not a sequence symbol; operand of 
PUNCH, TITLE, MNOTE not enclosed in guotes. 


Invalid delimiter, too many terms in expression, 8 
too many levels of parentheses, two operators 

in succession, two terms in succession, or 

illegal character. 


A system variable symbol appears in the name 8 
field of a SET statement, is declared in a GBL 

or LCL statement, or is an unsubscripted 

&SYSLIST in a context other than N'&SYSLIST. 


There is an unpaired apostrophe or ampersand in 8 
the statement. 


Symbol in operation code field does not 12 
correspond to a valid machine or assembler 
operation code or to any operation code ina 
Macro prototype statement. If the statement 
is OPSYN, the operand entry is not a defined 
machine or extended operation code, or the 
operand entry is omitted and the name entry 
is not a defined machine or extended oper- 
ation code. If the DOS option is in effect, 
DXD and CXD operation codes will be flagged 
as undefined. (See "Assembler Options". ) 


Syntax error inside a macro definition, e.g., 8 
the argument of the attribute reference is not 
a symbolic parameter. 


Code 





ITEU090 


IEU091 


ITEU092 


IEU093 


ITEU094 


TEU095 


IEU096 


IEU097 


IEU098 


IEU099 


Message 


INVALID SUBSCRIPT 


INVALID SELF-DEFINING 
TERM 


INVALID FORMAT FOR 
VARIABLE SYMBOL 


UNBALANCED PAREN~ 
THESIS OR EXCESSIVE 
LEFT PARENTHESES 


INVALID OR ILLEGAL 
NAME OR OPERATION IN 
PROTOTYPE STATEMENT 


ENTRY TABLE OVERFLOW 


MACRO INSTRUCTION OR 
PROTOTYPE OPERAND 
EXCEEDS 255 CHARAC- 
TERS IN LENGTH 


INVALID FORMAT IN 
MACRO INSTRUCTION 
OPERAND OR PROTOTYPE 
PARAMETER 


EXCESSIVE NUMBER OF 
OPERANDS OR PARAM- 
ETERS 


POSITIONAL MACRO. 
INSTRUCTION OPERAND, 
PROTOTYPE PARAMETER 
OR EXTRA COMMA 
FOLLOWS KEYWORD 


Severity 


Explanation Code 
Syntax error, e.g., double subscript where 8 
Sinale subscript is required or vice versa; 
not right parenthesis after subscript. 
Value is too large or is inconsistent with the 8 
data type, e.g., severity code greater than 255. 
The first character after the ampersand is not 8 
alphabetic, or the variable symbol contains 
more than 8 characters, or failure to use 
double ampersand in TITLE card or character 
self-defining term. 
End of statement or card encountered before all 8 


parenthesis levels are satisfied. May be caused 
by embedded blank or other unexpected terminator, 
or failure to have a punch in continuation 
column. 


Name not blank or variable symbol, or variable 12 
symbol in name field is subscripted, or violation 

of rules for forming variable symbol (must be- 

gin with ampersand (&) followed by 1-7 letters 

and/or numbers first of which must be a letter), 

or statement following 'MACRO' is not a valid 
prototype statement. 


Number of ENTRY symbols, i.e., ENTRY instruc- 8 
tion operands, exceeds 100. 

Self-explanatory. 12 
This message can be caused by: A 


1. Illegal "=". 

2. A single "&" appears somewhere in the 
standard value assigned to a prototype 
keyword parameter. 

3. First character of a prototype parameter 


is not "&", 
4, Prototype parameter is a subscripted 
variable symbol. 
5. Invalid use of alternate format in proto- 
type statement, e.g., 
10 16 72 
PROTO &A,&B, 
or 
PROTO &A,&B, X 
&C 
6. Unintelligible prototype parameter, e.g., 
"GA*" or "GARE." 


7. Illegal (non-assembler) character appears 
in prototype parameter or macro instruction 


operand. 
Either the prototype has more than 200 param- 12 
eters, or the macro instruction has more than 


200 operands. 


Self-explanatory. | 12 
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Code 





IEU100 


IEULOL 


TEULO2 


IEU103 


IEU104 


TEU1O5 


IEULO6 


IEU107 


IEU1LO8 


IEU1LO9 


IEU110 


IEULI11 


TEUL12 


TEU116 


IEU117 


32 


Message 


STATEMENT COMPLEXITY 
EXCEEDED 


EOD ON SYSIN 
INVALID OR ILLEGAL 
IcTL 


ILLEGAL NAME IN 
OPERAND FIELD OF 
COPY CARD 

COPY CODE NOT FOUND 
EOD ON SYSTEM MACRO 
LIBRARY 


NCT NAME OF D&ECT 
OR DXD 


INVALID OPERAND 


PREMATURE EOD 


PRECISION LOST 


EXPRESSION VALUE 
TOO LARGE 


SYSGO DD CARD MISSING 
NOLOAD OPTION USED 


SYSPUNCH DD CARD 
MISSING NODECK OPTION 
USED 


ILLEGAL OPSYN 


OPSYN TABLE 
OVERFLOW 


Severity 


Explanation Code 
More than 32 operands in a DC, DS, DXD, or 8 
literal DC, or more than 50 terms in a statement. 
EOD before END card. 12 
The operands of the ICTL are out of range, or 16 


the ICTL is not the first statement in the 
input deck. 


Syntax error, e.g., symbol has more than 8 12 
characters or has an illegal character. 


The operand of a COPY statement specified 12 
COPY text which cannot be found in the library. 

EOD before MEND card. 12 
Referenced symbol expected to be DSECT name, 8 


but it is not. 


Invalid syntax in DC operand, e.g., invalid 4 
hexadecimal character in hexadecimal DC; 

operand string too long for X, B, C, DC's; 

operand unrecognizable, contains invalid value, 

or incorrectly specified. 


Indicates an internal assembler error; should 16 
not occur. 


Self-explanatory. 8 
Value of expression greater than -16777216 to 8 
+16777215. 


Expressions in EQU and ORG statements are 


‘flagged if (1) they include terms previously 


defined as negative values, or (2) positive 
terms give a result of more than three bytes 

in magnitude. The error indication may be 
erroneous due to (1) the treatment of negative 
values as three-byte positive values, or (2) 

the effect of large positive values on the 
location counter if a control section begins 
with a START statement having an operand greater 
than zero, or a control section is divided 

into subsections. 


Self-explanatory. 16 
Self-explanatory. 16 
An explicit or implicit machine operation, 8 


macro definition, or macro instruction preceded 
this statement. 


No room exists in symbol table for this and fol- 8 
lowing OPSYN definitions; generated operation 
codes may not be processed correctly. 


Code 


IEU997 


IEUI98 


TEU999 


Message 


SYSPRINT DD CARD 


MISSING NOLIST OPTION 


USED 


ASSEMBLY TERMINATED. 
MISSING DATA SET FOR 
(ddname) 


ASSEMBLY TERMINATED, 
jobname, stepname, 
unit address, device 
type, ddname, opera- 
tion attempted, 
error description 


severity 


Explanation _ Code 
Self-explanatory. Printed on console device. 0 
It is printed on SYSPRINT if possible, otherwise 20 


it is printed on the console device. 


Indicates a permanent I/O error. This message 20 
is produced by a SYNADAF macro instruction. It is 
printed on SYSPRINT if possible, otherwise on the 
console device. 
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TEXT (TXT) CARD FORMAT 


The format of the TXT cards is as follows: 


Columns Contents 

1 12-2-9 punch 

2-4 TXT 

5 Blank 

6-8 Relative address of first 
instruction on card 

9-10 Blank 

11-12 Byte count -- number of 
bytes in information 
field (cc 17-72) 

13-14 Blank 

15-16 ESDID 

17-72 56-byte information field 

73-76 Deck ID (from first TITLE 
card) 

77-80 Card sequence number 


RLD CARD FORMAT 


The format of the RLD card is as follows: 


Columns Contents 
1 12-2-9 punch 
2-4 RLD 
5-10 Blank 
11-12 Data field count -- number 
of bytes of information in 
data field (cc 17-72) 
13-16 Biank 
17-72 Data fields: 
17-18 Relocation ESDID 
19-20 Position ESDID 
21 Flag byte 
22-24 Absolute address to be 
relocated 
25-72 Remaining RLD entries 
73-76 Deck ID (from first TITLE 
card) 
77-80 Card sequence number 


If the rightmost bit of the flag byte is 
set, the following RLD entry has the 
same Relocation ESDID and Position ESDID, 
and this information will not be repeated; 
if the rightmost bit of the flag byte is 
not set, the next RLD entry has a different 
Relocation ESDID and/or Position ESDID, 
and both ESDIDs will be recorded. 

For example, if the RLD Entries 1, 2, 
and 3 of the program listing (Appendix C) 
contain the following information: 


Pos. Rel. 
ESDID ESDID Flag Address 
Entry 1 02 04 0c 000100 
Entry 2 02 04 oc 000104 
Entry 3 03 01 0c 000800 


APPENDIX B. OBJECT DECK OUTPUT 


Columns 17-36 of the RLD card would ap- 
pear as follows: 
Entry 1 





Entry 3 











17,18 19 20 21 22 23 241/25 26 27 28)29 30 31 32 33 34 35 36|37——~ 72 


| 90 [04 foo [oz] on} oof 01] oof ocf oo] 01] 04 J 00] 01 | 00] 03] oc} 00 Jos Joo 


——_——-—~ enn ny nnned 
ESD ID's 


Column: 




















Address Address ESD ID's Address blanks 





Flag Flag Flag 
(set) (not (not 
set) set) 


ESD CARD FORMAT 


The format of the ESD card is as follows: 


Columns Contents 
iL: 12-2-9 punch 
2-4 ESD 
5-10 Blank 
11-12 Variable field count -~ 
number of bytes of informa- 
tion in variable field 
(cc 17-64) 
13-14 Blank 
15-16 ESDID of first SD, XD, CM, 
PC, or ER in variable field 
17-64 Variable field. One to 
three 16-byte items of the 
following format: 
8 bytes -- Name, padded 
with blanks 
l byte -- ESD type code 
The hex value is: 
00 SD 
01 LD 
02 ER 
04 PC 
05 CM 
06 XD(PR) 
3 bytes -- Address 
1 byte -- Alignment if XD; 
otherwise blank 
3 bytes -- Length, LDID, or 
blank 
65-72 Blank 
73-76 Deck ID (from first TITLE 
card) 
77-80 Card sequence number 


END CARD FORMAT 


The format of the END card is as follows: 


Columns Contents 
1 12-2-9 punch 
2-4 END 
5 Blank 
6-8 Entry address from operand 


of END card in source deck 
(blank if no operand) 
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Page of GC26-~-3756 -4 
Revised June 1, 1970 
By TNL GN33-8075 


9-14 Blank 

15-16 ESDID of entry point (blank 
if no operand) 

Blank 

Version of the assembler 
(e.g., F 14FEB66, time 

of the assembly (hh.mm), 
and date of the assembly 


17-39 
40-62 


(mm/dd/yy). See 
"Assembler Listing" sec- 
tion.) 


TESTRAN (SYM) CARD FORMAT 

If requested by the user, the assembler 
punches out symbolic information for TES- 
TRAN concerning the assembled program. 
This output appears ahead of all loader 


text. The format of the card images for 
TESTRAN output is as follows: 
Columns Contents 
1 12-2-9 punch 
2-4 SYM 
5-10 Blank 
11-12 Variable field count -- 
number of bytes of text in 
variable field (cc 17-72) 
13-16 Blank 
17-72 Variable field (see below) 
73-76 Deck ID (from first TITLE 
card) 
77-80 Card sequence number 


The variable field (columns 17-72) con- 
tains up to 56 bytes of TESTRAN text. The 
items making the text are packed together, 
consequently only the last card may con- 
tain less than 56 bytes of text in the 
variable field. The formats of a text 
card and an individual text item are shown 
in Figure 8. The contents of the fields 
within an individual entry are as follows: 


Ls Organization (1 byte) 
Bat. 0s 
non-data type 
1 data type 
Bits 1-3 (if non-data type): 
000 = space 
001 = control section 
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010 = dummy control section 
011 = common 

100 = instruction 

101 = CCW 


Bit 1 (if data type): 

0 = no multiplicity 

1 = multiplicity (indicates 
presence of M field) 

Bit 2 (if data type): 

0 = independent (not a 
packed or zoned decimal 
constant) 

1 = cluster (packed or 
zoned decimal constant) 

Bit 3 (if data type): 
6) no scaling 


1-= scaling (indicates pres- 
ence of S field) 
Bit 4: 
O = name present 
l = name not present 
Bits 5-7: 


Length of name minus one 
2. Address (3 bytes) - displacement from 
base of control section 
3 Symbol Name (0-8 bytes) - symbolic 
name of particular item 


NOTE: The following fields are only pres- 
ent for data~type items. 


4, Data Type (1 byte) - contents in hex- 


adecimal 
00 = character 
04 = hexadecimal 
08 = binary 
10 = fixed point, full 
14 = fixed point, half 
18 = floating point, short 
1¢C = floating point, long 
20 = A-type or Q-type data 
24 = Y-type data 
28 = S-type data 
2C = V-type data 
30 = packed decimal 
34 = zoned decimal 
38 = L-type data 


Sy Length (2 bytes for character, hexa- 
decimal, or binary items; 1 byte for 
other types) -— length of data item 
minus 1 

6. Multiplicity - M field (3 bytes) - 
equals 1 if not present 

4% Scale - signed integer - S field (2 
bytes) - present only for F, H, E, D, 
P and Z type data, and only if scale 
is non-zero. 


1} 2 45 10 17:12 13 16 17 72 73 76 77 80 






Sequence 
Number 









TESTRAN text - packed entries 
















Entry 
(complete or 
end portion) 


Entry 
(complete or 
head portion) 







N complete entries 
N 2 ] 


Variable size entries 


Address Symbol Name 


ade 
factor 
3 2 


Figure 8. TESTRAN SYM Card Format 
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APPENDIX C. ASSEMBLER F PROGRAM LISTING 


The Assembler F listing shown in "The Assembler Listing," the headings on 


this appendix results from assembling the listing are numbered. 

the source program documented in an Since there were no errors in the 
appendix to the Assembler Language publi- assembly, a diagnostic list was not pro- 
cation. For easy reference to the duced. 


Each of the following pages repre- 


explanations that appear in the section sents one printer-produced listing page. 








EXAM Q) ® (©) © © EXTERNAL SYMBOL DICTIONARY 


SYMBOL Type 1D) ADUR LENGTH LO ID 


PAGE 1 
00.16 4/11/66 


SAMPLR sb) O01 000000 000388 
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EXAM PAGE 1 
LUC GBJECT CuwuE ADDR1 ADDR2 STMT SOURCE STATEMENT F 14FEB66 4/11/66 

1 ¥*% THIS IS THE EXECUTABLE SAMPLE PROGRAM SHOWN IN THE SRL - * 

2 ** ASSEMBLER LANGUAGE MANUAL. = * 
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@ (2) 


EXAM SAMPLE PRUGRAM 


O@ @ @Q@ @® 


iuc =UBJECT CODE AUDR1 ADLR2 STM 


4 


000000 57 
58 


40 


SOURCE 


| 
| 
| 
i 
fe | 
| 


«TYPEDEH 
I 

ot 

ok 

&TYPE 
«MOVE 

* 


wo 

* 

o% 

« TYPECGK 
* 


ot 
ot 
at 
«ERRORIL 


@ERROR2 
«£RRORS 
«ERRORS 
* 


* 
* 


SAMPLR 
BEGIN 





STATEMENT F L4FER66 4/11/66 
PRINT DATA (7) samptooz 

SAMPLO93 
THIS IS THE MACRO DEFINITION SAMPLOO4 

SAMPLOOS 
MACRO SAMPLO06 
MOVE &1T0,&FROM SAMPLOO7 

SAMPLOOB 
DEFINE SETC SYMBOL SAMPLOO9 

SAMPLOLO 
LCLC TYPE SAMPLOLI 

SAMPLO12 
CHECK NUMBER OF OPERANDS SAMPLO13 

SAMPLO14 
AIF (N*ESYSLIST NE 2).ERRORL SAMPLOLS 

SAMPLOL6 
CHECK TYPE ATTRIBUTES OF OPERANDS SAMPLO17 

SAMPLOL8 
AIF = (T*ETO NE T*GFROM).ERRORZ SAMPLO19 
AIF = (T'&TO EQ "C# OR TYETO EQ *G* OR T#ETO EQ *K")D.TYPECGK = SAMPLOZ0 
AIF (T*ETO EQ "Dt OR T*ETO EQ *E* GR T*6TO EQ *H*).TYPEDEH  SAMPLO21 
AIF (T*6TO EQ "F*). MOVE SAMPLO22 
AGO = «ERROR3 SAMPLO23 
ANUP SAMPLO24 

SAMPLO25 
ASSIGN TYPE ATTRIBUTE TO SETC SYMBOL SAMPLO26 

SAMPLO27 
SETC T*ETO SAMPLO28 
ANOP SAMPLO29 
NEXT TwO STATEMENTS GENERATED FOR MOVE MACRO SAMPLO30 
LETYPE 2,6FROM SAMPLO31 
STETYPE 2810 SAMPLO32 
MEXIT SAMPLO33 

SAMPLO34 
CHECK LENGTH ATTRIBUTES OF OPERANDS SAMPLO35 

SAMPLO36 
AIF (L*ETO NE L*GFROM OR L*ETO GT 256).ERROR4 SAMPLO37 
NEXT STATEMENT GENERATED FOR MOVE MACRO SAMPLO38 
MVC & T0,6FROM SAMPLO39 
MEXIT SAMPLOGO 

SAMPLO41 
ERROR MESSAGES FOR INVALID MOVE MACRO INSTRUCTIONS SAMPLO42 

SAMPL043 
MNOTE 1,*IMPROPER NUMBER OF OPERANDS, NO STATEMENTS GENERATED* SAMPLO44 
MEXIT SAMPLO45 
MNOTE 1,*OPERAND TYPES DIFFERENT, NO STATEMENTS GENERATED® SAMPL046 
MEXIT SAMPLO47 
MNOTE 1," IMPROPER OPERAND TYPES, NO STATEMENTS GENERATED® SAMPLO48 
MEXIT SAMPLO49 
MNOTE 1,° IMPROPER OPERAND LENGTHS, NO STATEMENTS GENERATED!® SAMPLO50 
MEND SAMPLO51 

SAMPLO52 
MALN ROUTINE SAMPLO53 

SAMPLO54 
CSECT SAMPLOS5 


SAVE C1L4el2)oe* 








SAMPLO056 



























@ 


EXAM SAMPLE PROGRAM 


LUC UBJECT CODE ADOR1 ADDR2 STMT SOURCE STATEMENT F 14FEB66 




























OGO000 47FO FOOA O000A 59+BEGIN 8 10(0,15) BRANCH ARDUND ID 
000004 05 60+ OC AL1(5) 
000005 C2b5C7C9D5 6l+ oc CL5*BEGIN® IDENTIFIER 
QUOOUA 90EC DOOC oo0oc 62+ STM 1412312113) SAVE REGISTERS 
O000VE 05C0 63 BALR) R12s0 ESTABLISH ADDRESSABILITY OF PROGRAM SAMPLO57 
000010 64 USING *»R12 AND TELL THE ASSEMBLER WHAT BASE TO USE SAMPLO58 
000010 50L0 COBS8 000c8s 65 ST 13,SAVE13 SAMPLO59 
000614 9657 C390 003A0 66 LM RS sRTP=A(LISTAREA,1LOeLISTEND) LOAD LIST AREA PARAMETERS SAMPLOG6O 
000000 67 USING LISTeRS REGISTER 5 POINTS TO THE LIST SAMPLO61 
000018 45£0 COKE OOOCE 68 MORE BAL R14,SEARCH FIND LIST ENTRY IN TABLE SAMPLO62 
OO001C 9180 COBC ooocc 69 ™ SWITCH,sNONE CHECK TO SEE IF NAME WAS FOUND SAMPLO63 
000020 4710 COBO Q00co 70 60 NOTTHERE BRANCH IF NOT SAMPLO64 
000000 7 USING TABLE,sR1 REGISTER 1 NOW POINTS TO TABLE ENTRY SAMPLO65 
72 MOVE TSWITCH,LSWITCH MOVE FUNCTIONS SAMPL066 
13+* NEXT STATEMENT GENERATED FOR MOVE MACRO 
000024 0200 1003 5008 00003 00008 74+ MVC TSWITCHyLSWITCH 
75 MOVE TNUMBER,LNUMBER FROM LIST ENTRY SAMPLO67 
T6+* NEXT STATEMENT GENERATED FOR MOVE MACRO 
QUGOZA D20z 1000 5009 00000 GO0009 17+ MVC TNUMBER, LNUMBER 
78 MOVE TADDRESS,LADDRESS TU TABLE ENTRY SAMPLO68 
194% NEXT TWO STATEMENTS GENERATED FOR MOVE MACRO 
000030 5&20 500C 0000C 80+ L 2yLADDRESS 
000034 5020 1004 00004 81+ ST 2sTADDRESS 
000038 6756 C008 00018 62 LISTLOOP BXLE R5,R6,MORE LOUP THROUGH THE LIST SAMPLO69 
Q0003C DSEF C240 COFO 00250 00100 83 CLC TESTTABL (240) »TABLAREA SAMPLOTO 
000042 4770 CO7TC OGO6C 84 BNE NOTRIGHT SAMPLO71 
000046 O55F C330 C1EO 00340 001FO 85 CLC TESTLIST(96) sLISTAREA SAMPLO72 
O0004C 4770 COTC oo0sc 86 BNE NOTRIGHT SAMPLOT73 
87 WTO "ASSEMBLER SAMPLE PROGRAM SUCCESSFUL® SAMPLOT4 
000050 88+ CNOP 024 
000050 4510 C06L ooo7c 89+ BAL 1,1HBOOOSA BRANCH AROUND MESSAGE 
000054 0027 90+ oc AL2(IHBOO05-*) MESSAGE LENGTH 
000056 0000 91+ oc AL2(0) 


000058 ClEZE2C5D4C203C5 92+ oc C*ASSEMBLER SAMPLE PROGRAM SUCCESSFUL* MESSAGE 
000060 0940E2C1D4U07D3C5 

000068 400709D06C709C104 

O00070 40G2E4C3C3C5E2ZE2 

0000768 C6L4D3 


000078 93+1HBO005S EQU * 

oo007c 94+I1HBOOO5A DS OH 

00007C OAZ3 95+ svc 35 ISSUE SVC 

OOOOTE 58D0 COBS8 600cs 96 EXIT L R135SAVE13 SAMPLO75 
97 RETURN (14,12) ,RC=0 SAMPLOT6 

000082 98EC DOOC o000c 98+ Ls 14912212013) RESTORE THE REGISTERS 

000086 41FO 0000 00000 99+ LA 15,0(020) LOAD RETURN CODE 

QOOO8A O7FE 100+ BR 14 RETURN 
101 * SAMPLO77 
102 NOTRIGHT WTO "ASSEMBLER SAMPLE PROGRAM UNSUCCESSFUL‘ SAMPLO78 

o000sc 103+ CNOP 094 

O00008C 4510 COAA OOOBA LO4+NOTRIGHT BAL 1,IHBOOO7A BRANCH AROUND MESSAGE 

000090 0029 105+ oc AL2(CIHBOOO7—*) MESSAGE LENGTH 

000092 9000 106+ oc AL2(0) 

000094 ClE2ZE2C504C203C5 107+ oc C* ASSEMBLER SAMPLE PROGRAM UNSUCCESSFUL* MESSAGE 













00009C D940E2C1D40703C5 
O000A4 40D7D9D6C709C 104 
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ern: rman eesti Re EA AAA A A te 


Q @) 


EXAM SAMPLE PROGRAM 


@) @  @® 


LuC = UBYECT CUWE ADDRI ADOR2 STMT SOURCE STATEMENT ; F 


OOOOAC 4O0E4DSE2E4C3C305 
000054 EZE2CHESD? 











































Ou00B9 108+]THBOOO7 EQU * 

QOO0BA 109+1HBOOOTA DS OH 

OQO00KA OA23 110+ Svc 35 ISSUE SVC 

OOOOBC 47+0 COGE OOO7TE di 8 €XIT SAMPLOT79 

Q000CO 9680 5008 00008 112 MNOTTHERE OL LSWITCHs,NONE TURN ON SWITCH IN LIST ENTRY SAMPLO8B0 

O000L4 47FC CO2d 00038 113 8 LISTLOGP 60 BACK AND LOOP SAMPLO81 

Q0000Cu 00000000 114 SAVE13 oc Foe SAMPLO8B2 

goooce 00 aiS SWITCH oc x*oo* SAMPLO83 

000080 116 NONE EQU x*80° SAMPLO84 
ili * SAMPLO85 
116 *# BINARY SEARCH ROUTINE SAMPLO 86 
119 * SAMPLOB7 

QoUocc 00 

QOOOOCE 947F COBC Ooocc 120 SEARCH NI SWITCH,255-NONE TURN OFF NOT FOUND SWITCH SAMPLO88 

000002 9613 C39C OQ3AC 121 LM R1,R3,2=F*128,4,128" LOAD TABLE PARAMETERS SAMPLO89 

000006 4111 COEO QooFO 122 LA Rl»TABLAREA~16(R1L) GET ADDRESS OF MIDOLE ENTRY SAMPLO90 

OGOODA 8630 OO0L coool 123 LOUP SRL R391 DIVIDE INCREMENT BY 2 SAMPLOOL 

o000DE D507 5000 1008 00000 00008 124 cic LNAME » TNAME COMPARE LIST ENTRY WITH TABLE ENTRY SAMPLO92 

OOOOES 4720 COE4 OOOFS 125 BH HIGHER BRANCH IF SHOULD BE HIGHER IN TABLE SAMPLO93 

O000E& O7bE 126 BCR BrR14 EXIT IF FOUND SAMPLO94 
127 SR R1,R3 OTHERWISE IT IS LOWER IN THE TABLE XSAMPLO95 

QOOOEA 1813 SO SUBTRACT INCREMENT SAMPLO96 

OQOOGOEL 4620 COCA QUODA 128 BCT R2,L00P LOOP 4 TIMES SAMPLOOT 

QOOOFO 47FO COEA OOOFA 129 8 NUT FOUND ARGUMENT IS NOT IN THE TABLE SAMPLO98 

OQUOUF4 1Al13 130 HIGHER AR R1,R3 ADD INCREMENT SAMPLO99 

OOOOF6 462C COCA OOODA 131 BCT R2,L00P LOOP 4 TIMES SAMPL100 

OOOOFA 9680 COBC ooocc 132 NUTFOUND OI SWITCH, NONE TURN ON NOT FOUND SWITCH SAMPL101 

O0OOOFE O7FE 133 BR R14 EXIT SAMPL102 
134 * SAMPL103 
135 * THIS 18 THE TABLE SAMPL104 
136 * SAMPL105 

000100 137 oS oD SAMPL106 

000100 00000G0000000000 138 TABLAREA DC XL&*O",CLB*ALPHA® SAMPL107 

000108 C1D3D7C8C1404040 

000110 0000000000000000 139 oc XL8"O*,CLE*BETA® SAMPL108 

000118 C205E3C140404040 

00012G eco000Ccd000000000 140 oc XL8"O",CLE*DELTA® SAMPL109 

000128 C4C5D3E301404049 

000130 00000C0000000009 141 oc XL8°O",CL8*EPSILON® SAMPL110 

000138 C5D7E2C903060540 

000140 00G0C000000000000 142 oc XL8"O",CLB*ETA® SAMPLI11 

000148 C5&3C 14040404040 

000150 0000000000000000 143 oc XL8*°O",CLB*GAMMA® SAMPL112 

000158 C7C10404C 1404040 

QG00160 0000000000000000 144 oc XL8"0*,CLB*IOTAS SAMPL113 

000168 C9D6E3C 140404040 

000170. 0G00000000000000 145 oc XL8'O",CLE"KAPPA® SAMPL114 

000178 02C10707C01404040 

000180 0000000000000000 146 oc XL8*O* ,CL8*LAMBDA* SAMPLIIS 

000168 030104C2C4C14040 

000190 0000000000000000 147 oc XL8*O", CLE" MUS SAMPL116 

000198 D4E4404040404040 

Q0001A0 0C00000000000000 148 oc XL8*0*,CL8*NU® SAMPL117 





ee 





eaten mrmaesnen anemia nena ee a a 
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EXAM SAMPLE PKOGKAM 


@ ®Q@ @® 


LGC OBJECT CUdE ADOR1 ADDR2 STMT SGURCE STATEMENT 


QVOOLAS 05t 4404040404040 
000180 0000000000000000 149 oc XL8*0",sCL8* OMICRON® 
000188 Dév4C9C 30906U540 
0001C0 000G000000000000 150 bc XL8'0* sCLB*PHI® SAMPL1I19 
O001LK DIC&C 94040404040 
000100 0000000000000000 151 oc XL8*0",CLE*SIGMAt SAMPL120 
000106 E2090 70401404040 
0001EO0 0000000000000000 152 ; oc XL8°0",CLE*ZETA® SAMPL121 
O00LES £905E3C140404040 
153 SAMPL122 
154 THIS IS THE LIST SAMPL123 
155 SAMPL124 
OOV1LFO 03C1D4C204C14040 156 LISTAREA DC CL8*LAMBDA® 4 X* OA® gFL3°29*,A( BEGIN) SAMPL125 
QO01FS 0AGQ0001D00000000 
C00200 £905E30140404040 157 oc CLB*ZETA® ,X*05%yFL3°5* ,A(LOOP) SAMPL126 
0002048 05000005000000DA 
000210 E3C8C5E3C1404040 158 oc CLE*THETA®,X*02* »FL3°45",A( BEGIN) SAMPLI27 
000216 0200G02000000000 
000220 £301644040404040 159 oc CL8* TAU 4 X*00* sFL3°0*,AL1) SAMPL128 
000228 0600000000000001 
900230 D3C9E2E340404040 160 oc CLE *LIST® sX*1LF* pFL3*465%2A(0) SAMPL129 
000238 1F00C1U100000000 
000240 C103070801404040 161 LISTEND OC CLE* ALPHA® 9 X*00*sFL3°1L" A123) SAMPL130 
000248 0000G00100000078 
162 SAMPL131 
163 THIS IS THE CONTROL TABLE SAMPL132 
164 SAMPL133 
000250 165 0S oD SAMPL134 
000250 0000010000000078 166 TESTTABL DC FL3"*1%sX*00%, A123) -CLE*ALPHA® SAMPL135 
000258 C1030708C1404040 
000260 0000000000000000 167 oc XL8°O",CLA*BETA* SAMPL136 
000268 €205E30140404040 
000270 0000000000000G00 ; 168 oc XL8°O" sCL8*DELTA® SAMPL137 
0002Z7% C40503E3C1404040 
000280 00000C0000000000 169 oc XL8*°O",CLS*EPSILON® SAMPL138 
000288 ©5076 20903060540 
00029uU 0600000000000000 170 oc XL8*0* ,CLB*ETA® SAMPL139 
000298 C5t3C 14040404040 : 
g00ZAU 0000000000000000 171 oc XL8*0",CLE*GAMMA® SAMPL140 
Q002ZA8 C7010D404C1404040 
000280 0C000G0000000000 172 oc XL8°O*,CL8* IOTA* SAMPLI141 
000ZBb C9L6E3C140404040 
0002C0 0000060000000000 173 oc XL8°O* eCLE*KAPPA® SAMPL142 
0002C4 D2C1070701404040 
000200 0000100A00000000 174 oc FL3*29*,X*O0A® ,A( BEGIN), CLB*LAMBDA® SAMPL143 
(000208 030104C0204C14040 5 
0002E0 0600000000000000 175 oc XL8°O*,CLB*MUS SAMPL144 
O00ZE8 04F4404040404040 
0002FO 0000000000000000 176 oc XL8°O*»CLE*NUS SAMPL145 
Q002ZFS D5E4404040404040 
0004300 0000000000000000 177 boc XL8*0*,CL8* OMICRON® SAMPL146 
000308 0604C9C3D9D6D540 
000310 0600000000000000 178 DC = XL B*0*,CLE*PHI® SAMPL147 
000318 07080 94040404040 oe ; 
000320 00000C60000000000 179 oc XLB°O%sCLB*SIGMA® | SAMPL148 
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EXAM SAMPLE PRUGKAM 


@ 


Loc) «=(OBVECT COE AODR1 ADDR2Z STMT SGURCE STATEMENT F 14FEB66 4/11/66 





















































000326 £2C9C 70401404040 
00330 GO0U05G5000C00DA 180 oc FL3°5%,X"05",ACLOOP) »CLE"ZETAS SAMPL1L49 
000338 E90563C140404040 


18l * SAMPL150 
182 * THIS IS THE CONTROL LIST SAMPLI51 
183 SAMPL152 
000340 0301040204C14040 18% TESTLIST DC CL8*LAMBDA® 4X" 0A* gFL3"*29" ,A( BEGIN?) SAMPL153 
000345 GA000C10H00000000 
006350 £90563C 140404040 185 DC CLBE*ZETA",X*05" sFL3"5*,A( LOOP) SAMPL154 
000356 O05000005UV00000DA 
000360 £308C5E3C1404040 166 oC CLE* THETA yX*82%,FL3°45' sA( BEGIN) SAMPL155 
0003608 8200002D00000000 
000370 £€301£4404C404040 167 OC CLB* TAU 4X* 80% yFL3"O*,A(L) SAMPL156 
000378 8€00000000000001 
000380 0309£2E340404040 183 oc CLBYLIST* X*9F",FL3°465%,A10) SAMPL157 
000388 9F00010100000000 
000390 Cib30 10801404040 189 oc CLE*ALPHA® ¢X*00",FL3°1' ,A(123) SAMPL158 
0003968 O€000001L0G00U0TB 
190 * SAMPL159 
19i *# THESE ARE THE SYMBOLIC REGISTERS SAMPL160 
192 4 SAMPL161 
aouo0d 193 RO EQU .¢) SAMPL162 
000001 194 R1 EQU 1 SAMPL163 
coo0002 195 k2 EQU 2 SAMPL164 
000003 196 R3 EQU 3 SAMPL165 
000005 197 R5 EQuU 5 SAMPL166 
000006 196 R6 EQuU 6 SAMPLI67 
000007 199 R7 EQU 7 SAMPL168 
o0o00c 200 R12 £QU 12 SAMPL169 
o0a00g0D 201 R13 EQu 13 SAMPL170 
QOO0000E 202 K14 EQU 14 SAMPLI71L 
OQUOOOF 203 RLS EQU 15 SAMPL172 
204 * SAMPL173 
205 * THIS IS THE FORMAT DEFINITION OF LIST ENTRYS SAMPL174 
206 * y SAMPL175 
000000 207 LIST OSECT SAMPLIT76 
000000 208 LNAME ODS CLE SAMPL1T7T 
000008 209 LSWITCH DS c SAMPL178 
000009 210 LNUMBER DS FL3 SAMPL179 
Qoo00c 21), LADDRESS OS F SAMPL180 
2lz¢ * . SAMPL181 
2a * THIS IS THE FORMAT DEFINITION OF TABLE ENTRYS SAMPL182 
214 * SAMPL183 
o0u000 215 TABLE DSECT SAMPL184 
oc0000 216 TNUMBER OS FL3 SAMPL185 
000003 217 TSWITCH ODS Cc SAMPL186 
000004 218 TAODRESS DS F SAMPL187 
000008 219 TNAME DS cLs SAMPL188 
000000 220 END BEGIN SAMPL189 
000000 
0003A0 
0003A0 
0003A0 OQOOOCOI1FO 221 S=AILISTAREAs16eLISTEND) 
000344 0000008000000004 222 =F°12894,128* 


QO03AC 00000080 
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EXAM RELOCATION DICTIONARY 


Oo ®DY @ @® 


PUS.1b RKEL-1D FLAGS ADDRESS 


ol Ol oc OOOLFC 
ol ol oc O00zZ20C 
01 G1 oc oo02ic 
OL Ol oc 0002D4 
ol ol oc 000334 
Ol op oc 00034C 
01 ol oc 00035C 
ol Ol oc 00036C 


0003A0 
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@ 


EXAM CROSS-REFERENCE 


® © @® ® 


SYMbUL Leh VALUE UEFN REFERENCES 


BEGIN 00004 000000 0059 0156 0158 0174 0184 0186 0220 
EXIT 00004 OOOOTE 0096 0111 

HIGHER 000G2 OOOCF4 0130 0125 

THbO00S OGOOL OO00G7B 0093 0090 

{HBOOGSA OO0C2 OODDTC 0094 0089 

HBOUOT OCQ0L 0000B9 0108 0105 

THBOOO7A O0OC2 YOOOA 0109 0104 

LADDRESS 0000% OOGOOC 0211 0080 

LIsT QO00L 000000 0207 0067 

LISTAREA O000C8 OO01FO 0156 0066 0065 O221 
LESTENY O00C3 000240 016i 0066 0221 

LiSTLGOP OOOC% 000038 0082 0113 

LNAME G0008 000000 0208 0124 

LNUMbER 00003 000009 0210 oo77 

Loop 00004 QO0OVA 0123 0128 O131 0157 O180 0185 
USWITCH OCOCL 000008 0209 0074 O1l2 

MORE 00604 000018 0068 0082 

NONE GO00L 000080 0116 0069 O112 0120 0132 
NOTFOUND 00064 OOOOFA 0132 0129 

NUTKIGHT G000% O000K8C 0104 0084 0086 

NUTTHERE O0OC4 QOOCCCO 0112 0070 

RO 00001 9000000 0193 

R1 00061 Q00001 0194 OO7L O1Z1 O122 O122 O127 0130 
R1lz 06001 O0000C 0200 0063 0064 

R13 00001 000000 O201 0096 

K14 00001 OOODDE 0202 0068 O126 0133 

R15 00001 OQOOOUF 0203 

Re OCOG]l 000002 0195 0128 O14) 

R3 00001 000003 0196 Ol21 O123 O127T 0130 
R5 QG0001 000005 0197 0066 0067 00862 

RG 000G1i 000006 0198 0082 

R? 00001 000007 0199 0066 

SAMPLR 00001 000G00 0057 0220 

SAVE13 000C% O000C8 0114 0U65 0096 

StAKCH 00664 QOOOCE 0120 0068 

SWITCH 00001 OQOOCOCC 0115 0069 0120 0132 
TABLAKEA G00C8 000100 0138 0083 0122 : 
TABLE 00001 000000 0215 0071 

TADDRESS 00004 000004 0218 Qos 

FESTLAIST 000C8 000340 0184 0085 

TESTTABL O00C3 000250 0166 0083 

TNAME 0G008 000008 0219 0124 

TNUMBER O00C3 000000 0216 o0o7T 

TSwiTCH OG001 Q00C03 0217 0074 


NO STATEMENTS FLAGGED IN THIS ASSEMBLY : : 
*STATISTICS*® SUURCE RECORDS (SYSIN) = 225 SJURCE RECIROS CSYSLEB) = 40 


351 PRINTEO LINES 
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*OPTIGNS IN &FFECT*® LIST, NODECK, NULUOADs NIRENTy XREF, NUTESTy ALGNy US LINECNT 


58 





4/11/66 





APPENDIX D. DYNAMIC INVOCATION OF THE ASSEMBLER 


The Assembler can be invoked by a problem The option list must begin on a 
program at execution time through the use halfword boundary. The first two 
of the CALL, LINK, XCTL, or ATTACH macro bytes contain a count of the number of 
instructions. If the XCTL macro instruction bytes in the remainder of the list. 
is used to invoke the Assembler, then no If no options are specified, the count 
user options may be stated. The Assembler must be zero. The option list is free 
will use the standard default, as set during form with each field separated by a 
system generation, for each option. comma. No blanks or zeros should 

If the Assembler is invoked by CALL, LINK, appear in the list. 


or ATTACH, the user may supply: 
ddnamelist - specifies the address of a 


1) The Assembler options variable length list containing al- 
2) The ddnames of the data sets to be used ternate ddnames for the data sets used 
during processing during compiler processing. If stand- 


ard ddnames are used then this operand 
may be omitted. 
The ddname list must begin on a 


bytes contain a count of the number of 


[symbol } IEUASM, (optionlist bytes in the remainder of the list. 
Each name of less than eight bytes 
must be left-justified and padded with 


[,ddnamelist] ), VL 


7 blanks. If an alternate ddname is 
oe | EE EAs omitted, the standard name will be 
ATTACH PARAM=(optionlist assumed. If the name is omitted 


within the list, the 8-byte entry must 
contain binary zeros. Names can be 
omitted from the end merely by shorten- 
ing the list. The sequence of the 8- 
byte entries in the ddname list is as 
follows: 


[,ddnamelist] ), VL=1 





EP - specifies the symbolic name of the 
Assembler. The entry point at which 
execution is to begin is determined by 


Entry Alternate Name 


the control program (from the library 5 its ae 
directory entry). | 3 noe. applicable 
PARAM - specifies, as a sublist, address 4 SYSLIB 
parameters to be passed from the prob- 5 SYSIN 
lem program to the Assembler. The 6 SYSPRINT 
first word in the address parameter i SYSPUNCH 
list contains the address of the option 8 sySuT1 
list. The second word contains the 3 SYSUT2 
address of the ddname list. 10 SYSUT3 
: ll SYSGO 
optionlist - specifies the address of a 
variable length list containing the VL - specifies that the sign bit is to be 
options. This address must be written set to 1 in the last word of the 
even if no option list is provided. address parameter list. 
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Access methods 3 
BPAM (basic partitioned) 3 
BSAM (basic sequential) 3 
QSAM (queued sequential) 3 
ASMFC, cataloged procedure for assembly 6 
ASMFCG, cataloged procedure for assembly 
and loader-execution 9 
ASMFCL, cataloged procedure for assembly 
and linkage editing 7 
ASMFCLG, cataloged procedure for assembly, 
linkage editing, and execution 8 
Assembler cataloged procedures 6 
Assembler data sets 2 
Assembler dynamic invocation 
Assembler listing 1l 
(see also program listing) 
cross reference 14 
diagnostics 15 
external symbol dictionary 
relocation dictionary 14 
source and object program 
statistical messages 11 
Assembler options 2 
default entry 2 
Assembler portion limitations 


47 


ll 


13 


21 


Blocking and buffering information 5 
BPAM (Basic Partitioned Access Method) 3 
BSAM (Basic Sequential Access Method) 3 


Cataloged procedures 6 

for assembling (ASMFC) 6 

for assembling and linkage editing 
(ASMFCL) 7 

for assembling, linkage editing, and 
execution (ASMFCLG) 8 

for assembling and loader-execution 
(ASMFCG) 9 

overriding 9 


COND= parameter Sy “7-9 
Cross reference listing 14 
Data support of unaligned 23 
Data constants, Type L 23 
Data sets 2-5 
SYSGO 2,3 
SYSIN 2,3 
SYSLIB 2,3 
SYSPRINT 2,3 
SYSPUNCH 2,3 
SYSUT1, SYSUT2, SYSUT3 2,3 
DCB macro instruction 3 
DD statements 9 
ddnames 3 
Default entry 2 
Defining data set characteristics 3 
Device naming conventions (Table 3) 6 


Diagnostics 
listing 15 
messages 25-33 
Dictionaries 18-20 
additional requirements 20 
global 18-20 
local 18-20 


overflow errors 20 
Dictionary size and source statement 
complexity Ly} 
Dynamic invocation of the assembler 
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END card format 35 
ESD card format 35 


EXEC statements 9 


External Symbol Dictionary (ESD) 
listing A be 
Global dictionary 
at collection time 19 
at generation time 19 
IEBUPDAT utility program 17 
Job control statements 1 
Job steps 1 
Linkage statements (Figure 5) 18 


Listing, assembler nak 
Load module modification - 
restatement 17 
Loader-execution, ASMFCG cataloged 
procedure 9 
Local dictionary 
at collection 
at generation 


entry point 


19 
20 


time 
time 


library additions 16 
Macro-definition local definition para- 
meter table (Table 9) 20 
Macro generation and conditional assembly 
limitations 21 
Messages 
diagnostic 25-33 
statistical 11 
Model 85 Programming Considerations 
extended precision machine 
instructions 22 
OPSYN instruction 
Type L constant 23 
unaligned data 23 
Model 91 Programming Considerations 
Model 195 Programming Considerations 


Macro-definition 


22,23 
22 

21 

23 


Object deck output 
END card 35 
ESD card 35 


35-38 
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Object deck output (continued) 
RLD card 35 
TESTRAN SYM card 36 
TEXT (TXT) card 35 
Object module linkage 17 
OPSYN - operation code equate 
instruction 22 
Options, assembler 2 
default entry 2 
Overflow 
dictionary 20 
symbol table 21 
Overriding statements in cataloged 
procedures 9 


PARM field access 16 

PARM parameter 2,9 
Procedure (definition) 1 
Program listing, assembler F 
Program termination 16 


38-46 


QSAM (Queued Sequential Access Method) 
Relocation Dictionary listing 14 


Return codes 5 
RLD card format 31 
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Sample program listing 38-46 
Saving and restoring general register 
contents 16 
Severity code 
for diagnostic messages 25-33 
relation to return code § 5 
Source and object program 
listing 13 
Source statement complexity 21 
SPACE assembler instruction 11 
Statistical messages 11 
Symbol table, overflow 21 
SYSGO 3 
SYSIN 2% 
SYSLIB 25.3 
SYSPRINT 2, 
SYSPUNCH a5 
SYSUT1,2,3 


3 
' 


3 
3 
2,3 

TESTRAN (SYM) Card format 36 
TEXT (TXT) card format 35 
Type designators 11 


Type L data constants 23 
Types of ESD entries (Table 4) 11 


Unaligned data, support of 23 
Utility data sets 23 
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